Get all spaces

Retrieves a list of spaces accessible to the authenticated user with optional filtering
by space IDs and default space status. Spaces organize programs, tasks, and requests while controlling access through member management. Use this endpoint to list available spaces for selection in UI or to verify space access permissions.

Key Features:

  • Query spaces by specific IDs or retrieve all accessible spaces for the user
  • Filter by default space status to identify the primary space (only one default space exists per tenant)
  • Optionally expand user group memberships to see all individual user IDs
  • Navigate large result sets efficiently with cursor-based pagination
  • Results automatically filtered based on user's space access permissions

Authorization Logic:

  1. User must have a valid JWT token with viewing or management scopes
  2. Valid token is required
  3. Only returns spaces where the user is a member or has access through group membership
  4. No specific permissions are required for viewing spaces

Usage Example:
Display a list of available spaces in a workspace selector dropdown, identify the default space for initial navigation, or verify that a user has access to a specific space before performing operations.

Query Params
ids
array of strings

Optional array of specific space IDs to retrieve. When provided, only these spaces are returned
(filtered by user's access permissions).

ids
string

Optional cursor for pagination. Use the cursor from the previous response to retrieve the next page of results.

boolean

Optional filter to show only the default space (true) or only non-default spaces (false). Omit to show all.

int32

Optional limit for number of spaces to return per page. Defaults to 50 if not specified.

boolean

Optional flag to expand user groups and list all individual user IDs who have access to each space.
When true, resolves group memberships to show complete user lists.

Responses

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json