v1

latestOpenAPI 3.0.02026-08-04172371.9 KB
spaces

List spaces

Retrieves spaces that the current user has access to and match the query.

get/api/v1/spaces

Query parameters

actionstring

Action on space. Supports only "?action=publish".

environment.namestring

Environment name to filter by. For example, "?environment.name=Development". Use an empty value to return spaces with no environment.

environmentIdstring

Environment ID to filter by. For example, "?environmentId=67f4fba37f7cbb2f04ce727a". Use an empty value to return spaces with no environment.

limitinteger

Maximum number of spaces to return.

namestring

Space name to search and filter for. Case-insensitive open search with wildcards both as prefix and suffix. For example, "?name=fin" will get "finance", "Final" and "Griffin".

nextstring

The next page cursor. Next links make use of this.

ownerIdstring

Space ownerId to filter by. For example, "?ownerId=123".

prevstring

The previous page cursor. Previous links make use of this.

rolesRoleType[]

Comma-separated list of roles to filter spaces by the caller's assignment role. For example, "?roles=publisher,facilitator" returns spaces where the caller has the publisher or facilitator role.

sortstring

Field to sort by. Prefix with +/- to indicate asc/desc. For example, "?sort=+name" to sort ascending on Name. Supported fields are "type", "name" and "createdAt".

typestring

Type(s) of space to filter. For example, "?type=managed,shared".

Response

Spaces retrieved.