Skip to Content
ReferenceAPI Reference

Last Updated: 3/11/2026

LinkAce provides a full REST API for programmatic access to links, lists, tags, and notes. All data is sent and received as JSON.

Generating an API Token

Create API tokens in your user settings:

  1. Navigate to Settings → User API Tokens
  2. Click Create API Token
  3. Give the token a name (e.g., “Mobile App”, “Zapier Integration”)
  4. Copy the token — you won’t be able to see it again

You can create multiple tokens for different applications. Each token has full access to your account.

Using the API

All requests require three headers:

Accept: application/json
Content-Type: application/json
Authorization: Bearer YOUR-API-TOKEN-HERE

Example request to create a link using curl:

curl --request POST \
  --url https://your-linkace-url.com/api/v2/links \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR-API-TOKEN-HERE' \
  --data '{
    "url": "https://duckduckgo.com",
    "title": "DuckDuckGo",
    "description": "Privacy-focused search engine",
    "lists": [5],
    "tags": [9, 13],
    "visibility": 1,
    "check_disabled": false
  }'

Response (HTTP 200):

{
  "id": 1,
  "url": "https://duckduckgo.com",
  "title": "DuckDuckGo",
  "description": "Privacy-focused search engine",
  "visibility": 1,
  "user_id": 1,
  "icon": "fa fa-link",
  "status": 1,
  "check_disabled": false,
  "created_at": "2020-03-09T19:33:23.000000Z",
  "updated_at": "2020-03-09T19:33:23.000000Z"
}

API Endpoints

The LinkAce API is organized around resources:

  • GET /api/v2/links — List all links
  • POST /api/v2/links — Create a link
  • GET /api/v2/links/{id} — Get a specific link
  • PATCH /api/v2/links/{id} — Update a link
  • DELETE /api/v2/links/{id} — Delete a link
  • GET /api/v2/search/links — Search links

Lists

  • GET /api/v2/lists — List all lists
  • POST /api/v2/lists — Create a list
  • GET /api/v2/lists/{id} — Get a specific list
  • PATCH /api/v2/lists/{id} — Update a list
  • DELETE /api/v2/lists/{id} — Delete a list
  • GET /api/v2/lists/{id}/links — Get links in a list

Tags

  • GET /api/v2/tags — List all tags
  • POST /api/v2/tags — Create a tag
  • GET /api/v2/tags/{id} — Get a specific tag
  • PATCH /api/v2/tags/{id} — Update a tag
  • DELETE /api/v2/tags/{id} — Delete a tag
  • GET /api/v2/tags/{id}/links — Get links with a tag

Notes

  • POST /api/v2/notes — Create a note for a link
  • PATCH /api/v2/notes/{id} — Update a note
  • DELETE /api/v2/notes/{id} — Delete a note
  • GET /api/v2/links/{id}/notes — Get notes for a link

Bulk Operations

  • POST /api/v2/bulk/links — Create multiple links
  • PATCH /api/v2/bulk/links — Bulk edit links
  • DELETE /api/v2/bulk/delete — Bulk delete links, lists, or tags

Visibility Values

Links, lists, tags, and notes use numeric visibility codes:

  • 1 — Public (visible to anyone with access, including guests if enabled)
  • 2 — Internal (visible to logged-in users only)
  • 3 — Private (visible only to you)

Pagination

List endpoints support pagination:

GET /api/v2/links?per_page=50&page=2

Parameters:

  • per_page — Items per page (default 25, use -1 for all)
  • page — Page number (default 1)

Integrations

LinkAce is available on Zapier  and integrates with 2500+ applications for automation workflows.

Full API Documentation

The complete OpenAPI specification is available at:
https://your-linkace-url.com/openapi.json

You can import this into tools like Postman or Insomnia for interactive API exploration.

What’s Next

  • CLI Commands: Learn maintenance commands for backups and user management
AuthenticationCLI Commands