v1

latestOpenAPI 3.0.02026-07-2452762.3 KB
Workspaces

/workspaces

List the workspaces the authenticated user can view.

This is a discovery endpoint, with two consequences for how it is called:

  • Authentication must be an OAuth 2.0 bearer token. API key authentication is not accepted, because API-key requests require a workspace ID and this is a pre-workspace discovery route.
  • The x-air-workspace-id header is not required, since the purpose of the call is to discover which workspaces are available before any workspace-scoped call is made.

Results are filtered to workspaces the authenticated principal has permission to view.

Requires the workspace.read OAuth scope.

get/v1/workspaces

Response

List of workspaces the authenticated user can access