v4

OpenAPI 3.0.0MIT2026-07-311554531.6 MB

Contexts

Create a context

Create a new context with the specified type, id, and data. Returns 409 if context already exists. type and id are required fields, data is optional, if the context already exists, it returns the 409 response

post/v2/contexts

Request body

typestring required

Context type (e.g., tenant, app, workspace). Must be lowercase alphanumeric with optional separators.

idstring required

Unique identifier for this context. Must be lowercase alphanumeric with optional separators.

dataobject

Optional custom data to associate with this context.

Example request

{
  "type": "tenant",
  "id": "org-acme",
  "data": {
    "tenantName": "Acme Corp",
    "region": "us-east-1",
    "settings": {
      "theme": "dark"
    }
  }
}

Response

Created

typestring required

Context type (e.g., tenant, app, workspace)

idstring required

Unique identifier for this context

dataobject required

Custom data associated with this context

createdAtstring required

Creation timestamp

updatedAtstring required

Last update timestamp