API Reference

The current public API scope documented here is data source upload and status retrieval.

Base URL

All API requests should be made to:

https://api.ecue.ai/api/v1

Data source endpoints require bearer authentication. The API accepts:

Include your token in the Authorization header:

Authorization: Bearer YOUR_TOKEN

Data Upload
- POST /api/v1/data-sources - Upload a ZIP or TAR.GZ archive containing exactly one CSV/TSV file
- GET /api/v1/data-sources/{source_id} - Get import status
- PUT /api/v1/data-sources/{source_id} - Currently returns 501 not_implemented

No explicit per-endpoint rate limit is documented at this time.

Practical request limits for uploads:

Global request body limit middleware: 2GB
Data source archive extraction limit: 256MB (enforced for uploaded archive content)

Data source handlers return a flat error object:

{
  "error": "invalid_request",
  "message": "..."
}

Common examples include: