API reference.
Build powerful integrations with Clear Tangle.
The Clear Tangle API is a RESTful interface that lets you 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 URLhttps://api.cleartangle.com
Key features
SecureOAuth 2.0 and API key authentication.
FastLow-latency responses with global CDN.
RESTfulStandard 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:
First request · bash
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 response · json
{
"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:
Error response · json
{
"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