A space is a shared memory container that groups threads together. Messages from threads within a space are automatically embedded into a dedicated vector store, making knowledge accessible across all threads in the space. Additional external vector stores can be attached for expanded knowledge access.
id string
Unique identifier for the space (e.g., space_abc123...).
organization_id string
The organization this space belongs to.
created_by string
User ID of the space creator.
name string
Display name of the space (1–255 characters).
description string or null
Optional description of the space's purpose.
vector_store_id string or null
The space's auto-created dedicated vector store ID. Thread messages are automatically embedded here as shared memory.
access_mode string
Access control mode: private, organization, or public.
access_users array of strings or null
User IDs with explicit view access (when access_mode is private).
access_departments array of strings or null
Department IDs with view access.
editable_by_users array of strings or null
User IDs with edit access. Use "*" to grant edit access to all users.
editable_by_roles array of strings or null
Role IDs with edit access.
visible_to_roles array of strings or null
Role IDs with view access.
additional_vector_store_ids array of strings
IDs of external vector stores attached to this space. These provide supplementary knowledge during RAG-powered conversations. Defaults to [].
last_activity_at string (ISO 8601) or null
Timestamp of the most recent activity in the space.
created_at string (ISO 8601)
When the space was created.
updated_at string (ISO 8601)
When the space was last modified.
{
"id": "space_abc123def456",
"organization_id": "org_abc123",
"created_by": "usr_abc123",
"name": "Product Knowledge Base",
"description": "Shared memory for product team conversations",
"vector_store_id": "vs_auto123",
"access_mode": "organization",
"access_users": null,
"access_departments": null,
"editable_by_users": null,
"editable_by_roles": null,
"visible_to_roles": null,
"additional_vector_store_ids": ["vs_catalog456", "vs_docs789"],
"last_activity_at": "2026-02-26T15:30:00Z",
"created_at": "2026-02-26T10:00:00Z",
"updated_at": "2026-02-26T15:30:00Z"
}