Collate API Reference
The Collate API provides programmatic access to all metadata in your data catalog. Build integrations, automate workflows, and manage your data assets using our REST API or native SDKs.Base URL
All API requests should be made to your Collate instance. For self-hosted deployments, use your configured host.Quick Start
Get started with a simple API call to list tables in your catalog:Python
Authentication
All API requests require authentication using a JWT Bearer token. You can obtain a token by:- Bot Token: Go to Settings > Bots in the Collate UI to create a service account
- Personal Access Token: Go to your Profile > Access Tokens to generate a personal token
SDKs
We provide official SDKs for Python and Java:Error Handling
The API uses conventional HTTP response codes:| Code | Description |
|---|---|
200 | Success |
201 | Created |
400 | Bad Request - Invalid parameters |
401 | Unauthorized - Invalid or missing token |
403 | Forbidden - Insufficient permissions |
404 | Not Found - Resource doesn’t exist |
409 | Conflict - Resource already exists |
500 | Internal Server Error |
Rate Limits
API requests are subject to rate limiting to ensure fair usage. If you exceed the rate limit, you’ll receive a429 Too Many Requests response.