Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content
API reference

Organization, keys and projects

These operations read your organization, its inference keys, the provider keys it added, and its projects. They need a key of role read or higher.

All paths are under https://api.mubit.ai, with a management key in Authorization: Bearer. Management API covers keys, roles, pagination, retries and errors. The samples read the key from MUBIT_MANAGEMENT_KEY.

Get organization details

GET /api/v1/org

Returns the authenticated organization metadata and settings.

Role: read or higher.

curl
curl "https://api.mubit.ai/api/v1/org" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: Organization details

FieldTypeRequiredDescription
idstringyes
namestringyes
slugstringyes
created_atstring (date-time)yes
planstringno
{
  "id": "org_alpha",
  "name": "Acme Corporation",
  "slug": "acme",
  "created_at": "2026-10-26T12:00:00Z",
  "plan": "enterprise"
}
Errors
StatusMeaning
401Unauthenticated (missing, invalid, or expired token)
403Forbidden (role_required, role_ceiling, project_scoped, forbidden, or a key that isn't a management key)
500Internal server error

List inference keys

GET /api/v1/keys

Lists the organization's inference keys, active and revoked. The secrets are never returned.

Role: read or higher.

Parameters
NameInTypeRequiredDescription
limitqueryintegernoNumber of records to return (1-200)
cursorquerystringnoSealed pagination cursor from previous page
curl
curl "https://api.mubit.ai/api/v1/keys" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: List of inference keys

Each item of data:

FieldTypeRequiredDescription
idstringyes
namestringyes
prefixstringno
rolestring: user, reader, worker, adminyes
projectstring, nullableno
statusstring: active, revoked, expiredyes
created_atstring (date-time)yes
expires_atstring (date-time), nullableno
{
  "data": [
    {
      "id": "key_abc123",
      "name": "Production key",
      "prefix": "mbt_prod_",
      "role": "user",
      "project": "prj_prod",
      "status": "active",
      "created_at": "2026-10-01T00:00:00Z",
      "expires_at": "2027-01-01T00:00:00Z"
    }
  ],
  "next_cursor": null
}
Errors
StatusMeaning
401Unauthenticated (missing, invalid, or expired token)
403Forbidden (role_required, role_ceiling, project_scoped, forbidden, or a key that isn't a management key)
500Internal server error

List provider keys

GET /api/v1/providers

Lists the provider keys the organization added. The keys themselves are never returned.

Role: read or higher.

curl
curl "https://api.mubit.ai/api/v1/providers" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: Configured providers

Each item of data:

FieldTypeRequiredDescription
idstringnoThe saved key's id
providerstringyes
statusstringyes
labelstringno
regionstringno
last4stringnoThe last four characters of the saved key
versionintegernoGoes up by one at each rotate
created_atstring (date-time)no
updated_atstring (date-time)no
{
  "data": [
    {
      "provider": "openai",
      "status": "active",
      "created_at": "2026-10-01T00:00:00Z",
      "updated_at": "2026-10-15T00:00:00Z"
    },
    {
      "provider": "anthropic",
      "status": "active",
      "created_at": "2026-10-05T00:00:00Z",
      "updated_at": "2026-10-20T00:00:00Z"
    }
  ]
}
Errors
StatusMeaning
401Unauthenticated (missing, invalid, or expired token)
403Forbidden (role_required, role_ceiling, project_scoped, forbidden, or a key that isn't a management key)
500Internal server error

List projects

GET /api/v1/projects

Lists projects within the organization.

Role: read or higher.

Parameters
NameInTypeRequiredDescription
limitqueryintegernoNumber of records to return (1-200)
cursorquerystringnoSealed pagination cursor from previous page
curl
curl "https://api.mubit.ai/api/v1/projects" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: List of projects

Each item of data:

FieldTypeRequiredDescription
idstringyes
namestringyes
slugstringyes
environmentstringyes
created_atstring (date-time)yes
versionintegernoThe project record's version, where one is reported
{
  "data": [
    {
      "id": "prj_default",
      "name": "Default Project",
      "slug": "default",
      "environment": "production",
      "created_at": "2026-10-01T00:00:00Z"
    }
  ],
  "next_cursor": null
}
Errors
StatusMeaning
401Unauthenticated (missing, invalid, or expired token)
403Forbidden (role_required, role_ceiling, project_scoped, forbidden, or a key that isn't a management key)
500Internal server error

Get project details

GET /api/v1/projects/{project_id}

Retrieves details of a specific project.

Role: read or higher.

Parameters
NameInTypeRequiredDescription
project_idpathstringyes
curl
curl "https://api.mubit.ai/api/v1/projects/$PROJECT_ID" \
  -H "Authorization: Bearer $MUBIT_MANAGEMENT_KEY"

Response 200: Project details

FieldTypeRequiredDescription
idstringyes
namestringyes
slugstringyes
environmentstringyes
created_atstring (date-time)yes
versionintegernoThe project record's version, where one is reported
{
  "id": "prj_payments123",
  "name": "Payments",
  "slug": "payments",
  "environment": "production",
  "created_at": "2026-10-26T12:00:00Z"
}
Errors
StatusMeaning
401Unauthenticated (missing, invalid, or expired token)
403Forbidden (role_required, role_ceiling, project_scoped, forbidden, or a key that isn't a management key)
404Not found
500Internal server error