API Overview
The Hubify Labs REST API provides programmatic access to labs, experiments, agents, papers, tasks, and compute resources.Base URL
/v1. When a new API version is released, existing versions remain supported for at least 12 months.
Authentication
Every request requires anAuthorization header with either an API key or a Clerk JWT:
Request Format
- Content-Type:
application/jsonfor all request bodies - Method conventions:
GET(read),POST(create),PATCH(update),DELETE(remove) - IDs: String identifiers (e.g.,
lab_abc123,exp_054)
Response Format
All responses return JSON with a consistent structure:Pagination
List endpoints support cursor-based pagination:
Paginated responses include a
next_cursor field:
Rate Limits
Rate limit headers are included in every response:
Error Codes
Route Catalog
Every live route in the current API. All routes requireAuthorization: Bearer <token> unless Auth shows public. The Lab scope column indicates whether the route operates on a specific lab (pass labId in body or query).
Routes marked planned exist in the docs but have no handler yet. Ghost routes are noted at the top of their respective reference pages.