Skip to Content
Overview

Last Updated: 3/7/2026

API Documentation

LinkAce provides a comprehensive REST API that offers access to all features of the application. This allows you to integrate LinkAce with other apps, services, and automation tools.

Key Features

  • Full REST API: Access all LinkAce features programmatically
  • Token-based Authentication: Secure API access using personal access tokens
  • Zapier Integration: LinkAce is available on Zapier and integrates with over 2500+ applications
  • Multi-user Support: Each user can manage their own API tokens

Getting Started

Authentication

All API requests require authentication using a personal access token. You can generate API tokens from your user settings or system settings (for administrators).

Authentication Header:

Authorization: Bearer YOUR_API_TOKEN

Base URL

All API endpoints are relative to your LinkAce installation:

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

Available Resources

The LinkAce API provides access to the following resources:

  • Create, read, update, and delete bookmarks
  • Search and filter links
  • Manage link metadata (title, description, URL)
  • Set privacy settings (private/public)

Lists

  • Organize links into collections
  • Create and manage lists
  • Share lists with other users
  • Access list RSS feeds

Tags

  • Tag management and organization
  • Hierarchical tag structure support
  • Tag-based search and filtering
  • Share tags with other users

Users (Admin only)

  • User management
  • Permission control
  • Multi-user administration

API Token Management

There are two types of API tokens in LinkAce:

Personal API Tokens

Generated from User Settings, these tokens:

  • Have access to your personal bookmarks and collections
  • Respect your user permissions
  • Can be revoked at any time

See: User Settings

System API Tokens

Generated from System Settings (admin only), these tokens:

  • Have full system access
  • Can manage all users and content
  • Should be used carefully and kept secure

See: System API Tokens

Integration Options

Zapier

LinkAce is officially available on Zapier, enabling integration with over 2500+ applications without writing code.

Popular Zapier Workflows:

  • Save links from RSS feeds automatically
  • Create bookmarks from email
  • Share new bookmarks to social media
  • Sync bookmarks with other bookmark managers

Explore LinkAce on Zapier → 

Custom Integrations

Use the REST API to build custom integrations:

  • Browser extensions
  • Mobile apps
  • Automation scripts
  • Third-party service connectors

Rate Limiting

API requests are subject to rate limiting to ensure system stability. If you exceed the rate limit, you’ll receive a 429 Too Many Requests response.

Error Handling

The API uses standard HTTP status codes:

  • 200 OK - Request successful
  • 201 Created - Resource created successfully
  • 400 Bad Request - Invalid request parameters
  • 401 Unauthorized - Missing or invalid authentication
  • 403 Forbidden - Insufficient permissions
  • 404 Not Found - Resource not found
  • 422 Unprocessable Entity - Validation error
  • 429 Too Many Requests - Rate limit exceeded
  • 500 Internal Server Error - Server error

Best Practices

  1. Keep tokens secure: Never commit API tokens to version control or share them publicly
  2. Use appropriate token types: Use personal tokens for user-specific operations, system tokens only when necessary
  3. Handle errors gracefully: Implement proper error handling and retry logic
  4. Respect rate limits: Implement backoff strategies for rate-limited requests
  5. Use HTTPS: Always use HTTPS for API requests to protect your tokens

Community Resources

For questions, discussions, and community-built integrations:

Note: For detailed endpoint documentation, request/response schemas, and code examples, please refer to your LinkAce instance’s built-in API documentation or the OpenAPI specification.

ChangelogContributing