Create a new space with an auto-linked dedicated vector store for shared memory across threads.
Creates a new space within an organization. A dedicated vector store is automatically created and linked to the space for embedding thread messages as shared memory. Threads added to this space will have their messages embedded and retrievable across all threads in the space.
organization_id string required
The organization ID (e.g., org_abc123...).
name string required
Space name. Must be 1–255 characters.
description string optional
Optional description of the space.
access_mode string optional · Defaults to "private"
Access mode: private, organization, or public.
access_users array of strings optional
User IDs with view access.
access_departments array of strings optional
Department IDs with view access.
editable_by_users array of strings optional
User IDs with edit access. Use "*" for all users.
editable_by_roles array of strings optional
Role IDs with edit access. All IDs must refer to roles that exist in the organization.
visible_to_roles array of strings optional
Role IDs with view access. All IDs must refer to roles that exist in the organization.
access_departments IDs are also validated — all department IDs must exist in the organization. A 422 Validation Error is returned if any role or department ID is invalid.
A Space object with the auto-linked vector_store_id and empty additional_vector_store_ids.
- Bash
- Python
- JavaScript
curl -X POST "https://api.aitronos.com/v1/spaces/" \
-H "X-API-Key: $FREDDY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"organization_id": "org_abc123",
"name": "Product Knowledge Base",
"description": "Shared memory for product team conversations",
"access_mode": "organization"
}'