API Reference

Build powerful integrations with Clear Tangle

The Clear Tangle API is a RESTful interface that allows you to programmatically access and manage your captures, tasks, and conversations. Use it to build custom integrations, automate workflows, or extend Clear Tangle's capabilities.

API Base URL

https://api.cleartangle.com

Key Features

Secure

OAuth 2.0 and API key authentication

Fast

Low-latency responses with global CDN

RESTful

Standard HTTP methods and status codes

Quick Start

Get started with a simple API request. First, obtain your API key from the settings page, then make your first request:

curl -X GET "https://api.cleartangle.com/captures" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Endpoints

Authentication

Secure your API requests with token-based authentication

API Keys

Create and manage API keys with rate limits and usage tracking

Captures

Create, read, update, and delete captures

Tasks

Manage tasks and task lists programmatically

Chat

Integrate AI chat capabilities into your applications

Rate Limits

API requests are rate limited to ensure fair usage and system stability:

PlanRequests/minRequests/day
Free601,000
Pro30010,000
EnterpriseCustomCustom

Rate Limit Headers

Check the X-RateLimit-Remaining header in API responses to monitor your usage.

Response Format

All API responses are returned in JSON format with a consistent structure:

{
  "success": true,
  "data": {
    // Response data
  },
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 100
  }
}

Error Handling

When errors occur, the API returns appropriate HTTP status codes with detailed error messages:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": [
      { "field": "title", "message": "Title is required" }
    ]
  }
}
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error

SDKs & Libraries

Official client libraries are available for popular languages:

JavaScript/TypeScriptPythonGoRuby

View on GitHub