Skip to navigation
EnterpriseWorkspace Management

List Workspaces

List the workspaces the token can access, including each workspace’s ID. Use this endpoint to find the workspace_id that other workspace endpoints require.

The response includes the workspaces granted to the token, plus the workspace that owns each site granted to the token. It returns only active workspaces (not archived, deleted, or draft) and isn’t paginated.

This endpoint supports workspace API tokens and Data Client apps.

Required scope | workspace:read

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

A list of workspaces
workspaceslist of objects

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error