Skip to main content

API Overview

The Hubify Labs REST API provides programmatic access to labs, experiments, agents, papers, tasks, and compute resources.

Base URL

All endpoints are prefixed with /v1. When a new API version is released, existing versions remain supported for at least 12 months.

Authentication

Every request requires an Authorization header with either an API key or a Clerk JWT:
See Authentication for details on obtaining credentials.

Request Format

  • Content-Type: application/json for 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:
Error responses include a machine-readable code and human-readable message:

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 require Authorization: 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.

SDKs

Official SDKs are available for common languages: