Skip to main content

​
Endpoints

MethodPathDescription
GET/v1/organizationsList organizations for the current workspace.
POST/v1/organizationsCreate an organization record.
GET/v1/organizations/:idRetrieve a specific organization.
PATCH/v1/organizations/:idUpdate organization metadata.
DELETE/v1/organizations/:idSoft-delete an organization.
GET/v1/organizations/:id/capabilitiesList capability tags assigned to the organization.
POST/v1/organizations/:id/capabilitiesAdd a capability tag to the organization.
GET/v1/organizations/:id/api-keysList API keys for the organization.
POST/v1/organizations/:id/api-keysCreate an API key for the organization.
DELETE/v1/organizations/:id/api-keys/:keyIdRevoke an organization API key.
Organizations APIs require workspaceId in context (supplied automatically by workspace-scoped API keys). Read endpoints use the organizations:read scope; mutations require organizations:write.

​
Key concepts

  • Organization create/update payloads accept both camelCase and snake_case keys (legalName / legal_name, etc.). The API normalizes them before storing in the database.
  • Capabilities allow segmenting organizations by category (transport, accommodation, flight, experience, other) and optional mode identifiers/keys.
  • Deletions return { ok: true } when successful; attempting to delete a missing organization returns 404.
  • API Keys: Organizations can have their own API keys for B2B integrations. These keys are scoped to specific products and capabilities.

​
Webhooks

The following webhook events are emitted for organization operations:
EventDescription
organization.createdFired when a new organization is created.
organization.updatedFired when organization metadata is updated.
organization.deletedFired when an organization is deleted.
organization.api_key.createdFired when an API key is created for an organization.
organization.api_key.revokedFired when an organization API key is revoked.