SpaceService · SpaceService_ListSpaces
Protocol-derived reference. Authorization and instance policy still apply. Schema descriptions are inherited from the MIT-licensed application contract; examples here are not executed against a live server.
Access
Requires authentication and active membership in the relevant space. Instance administrator status does not bypass the space membership boundary.
Request
ListSpaces lists spaces of which the authenticated caller is a member.
GET
/api/v1/spacesParameters
| Name / location | Type / requirement | Description |
|---|---|---|
pageSizequery | integer (int32) Not marked required in OpenAPI | Optional. The maximum number of spaces to return. |
pageTokenquery | string Not marked required in OpenAPI | Optional. A token from a previous ListSpaces response. |
Request body
No request body is declared.
Responses
200 · OK
application/json · ListSpacesResponse
default · Default error response
application/json · Status
Complete operation definition
All declared constraints, media types and response details are retained below. Schema references link to their complete definitions.
Open JSON definition
{
"tags": [
"SpaceService"
],
"description": "ListSpaces lists spaces of which the authenticated caller is a member.",
"operationId": "SpaceService_ListSpaces",
"parameters": [
{
"name": "pageSize",
"in": "query",
"description": "Optional. The maximum number of spaces to return.",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "pageToken",
"in": "query",
"description": "Optional. A token from a previous ListSpaces response.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ListSpacesResponse"
}
}
}
},
"default": {
"description": "Default error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Status"
}
}
}
}
}
}