Skip to Content
Api ReferenceApi Overview

Last Updated: 3/16/2026

API Overview

LinkAce provides a comprehensive REST API that offers access to all features of the application. The API allows you to manage links, lists, tags, notes, and search functionality programmatically.

Base URL

All API requests should be made to:

https://your-linkace-instance.com/api/v2

Authentication

The LinkAce API uses Laravel Sanctum for authentication. You must include a valid API token in the Authorization header of each request:

Authorization: Bearer YOUR_API_TOKEN

API tokens can be created in two ways:

  • User API Tokens: For individual user access (see Configuration > User API Tokens)
  • System API Tokens: For system-wide access (see Configuration > System API Tokens)

Rate Limiting

API requests are rate-limited according to the API_RATE_LIMIT configuration setting. The default limit is defined in your application’s environment configuration.

API Versioning

The current API version is v2. The version can be checked by making a GET request to:

GET /api/version

Response:

{
  "version": "2.0"
}

Available Resources

The LinkAce API provides endpoints for the following resources:

  • GET /api/v2/links - List all links
  • GET /api/v2/links/{id} - Get a specific link
  • POST /api/v2/links - Create a new link
  • PATCH /api/v2/links/{id} - Update a link
  • DELETE /api/v2/links/{id} - Delete a link
  • GET /api/v2/links/check - Check link status
  • GET /api/v2/links/{id}/notes - Get notes for a link

Lists

  • GET /api/v2/lists - List all lists
  • GET /api/v2/lists/{id} - Get a specific list
  • POST /api/v2/lists - Create a new 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
  • GET /api/v2/tags/{id} - Get a specific tag
  • POST /api/v2/tags - Create a new 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 new note
  • PATCH /api/v2/notes/{id} - Update a note
  • DELETE /api/v2/notes/{id} - Delete a note

Bulk Operations

  • POST /api/v2/bulk/links - Bulk create links
  • POST /api/v2/bulk/lists - Bulk create lists
  • POST /api/v2/bulk/tags - Bulk create tags
  • PATCH /api/v2/bulk/links - Bulk update links
  • PATCH /api/v2/bulk/lists - Bulk update lists
  • PATCH /api/v2/bulk/tags - Bulk update tags
  • DELETE /api/v2/bulk/delete - Bulk delete items
  • GET /api/v2/search/links - Search links
  • GET /api/v2/search/tags - Search by tags
  • GET /api/v2/search/lists - Search by lists

Trash

  • GET /api/v2/trash/links - Get deleted links
  • GET /api/v2/trash/lists - Get deleted lists
  • GET /api/v2/trash/tags - Get deleted tags
  • GET /api/v2/trash/notes - Get deleted notes
  • DELETE /api/v2/trash/clear - Clear trash
  • PATCH /api/v2/trash/restore - Restore items from trash

Response Format

All API responses are returned in JSON format. Successful responses typically include the requested data, while error responses include error details.

Pagination

List endpoints support pagination. Use the following query parameters:

  • page - The page number to retrieve
  • per_page - Number of items per page (respects the system pagination limit)

Ordering

List endpoints support ordering with these query parameters:

  • order_by - Field to order by (varies by resource)
  • order_dir - Direction: asc or desc (default: desc)

Integrations

LinkAce is available on Zapier and integrates with over 2,500+ applications, making it easy to connect your bookmark archive with your favorite tools and services.

Next Steps

Links Api