GET /v1/projects/{id}/spaces
Lists the Project’s stored Spaces, with optional participant and Message filters. Results are eventually consistent.
- TypeScript
- Python
- Rust
- Go
TypeScript
Parameters
string
required
string (date-time)
Exclusive creation-time bound on a matching Message
string (date-time)
Inclusive creation-time bound on a matching Message
MessageDirection
Received or sent Message. All message-prefixed filters must match the same Message.
string
Comma-separated public content types to exclude from matching Messages. Requires messageResourceId. A group is excluded when its type or all its parts are excluded.
string
Resource ownership captured by a matching Message
string (date-time)
Exclusive upper bound on createdAt, RFC 3339. Cannot combine with updatedAt bounds.
string (date-time)
Inclusive lower bound on createdAt, RFC 3339. Cannot combine with updatedAt bounds.
SortOrder
Direction along orderBy; desc, the default, is newest first
SpaceOrderBy
Defaults to the filtered timestamp or created_at. Must match Space time bounds. last_message_created_at uses the latest Message creation time, accepts no Space time bounds, and puts empty Spaces last when descending. With messageResourceId, only that resource’s non-control Messages affect ordering.
integer
Items per page. A value above 100 returns at most 100 items.
string
Token from nextPageToken. Keep the same Project and query.
string
Matches participant phone or email handles case-insensitively, excluding participantId. Phone formatting characters are optional.
string
Restricts the page to Spaces this User participates in
Platform
Restricts the page to one platform
string (date-time)
Exclusive upper bound on updatedAt, RFC 3339. Cannot combine with createdAt bounds.
string (date-time)
Inclusive lower bound on updatedAt, RFC 3339. Cannot combine with createdAt bounds.
Returns
200 A page of Spaces in the requested order. SpacePage
Headers: Cache-Control, ETag. The raw response carries these headers; see Raw responses.
array of PlatformSpace
required
Unsupported platforms and records with unsupported data are omitted.
string
Continue with this token, even if items is empty. Omitted when no more pages remain.