# Space object

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.


```json Example
{
  "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"
}
```

## Related Resources

- [Create Space](/docs/api-reference/spaces/create)
- [Retrieve Space](/docs/api-reference/spaces/retrieve)
- [List Spaces](/docs/api-reference/spaces/list)
- [Update Space](/docs/api-reference/spaces/update)
- [Delete Space](/docs/api-reference/spaces/delete)
- [Add Thread to Space](/docs/api-reference/spaces/add-thread)
- [Add Vector Store to Space](/docs/api-reference/spaces/add-vector-store)