v1

latestOpenAPI 3.1.02026-08-06209117239.7 KB

spaces

Create a new space

Create a new memory space for the current user

post/spaces

Request body

namestring required

Space name

iconstring nullable

Emoji icon for space identification

colorstring nullable

Hex color code for space theming

template_typestring nullable

Template used: work, personal, learning, custom

privacy_levelstring nullable

Privacy setting: personal, shared, team

space_type'text_only' | 'multimodal'

Space type determines which Weaviate collection is used for storage.

Response

Successful Response

namestring required

Space name

iconstring nullable

Emoji icon for space identification

colorstring nullable

Hex color code for space theming

template_typestring nullable

Template used: work, personal, learning, custom

privacy_levelstring nullable

Privacy setting: personal, shared, team

space_type'text_only' | 'multimodal'

Space type determines which Weaviate collection is used for storage.

idstring required

Unique space identifier

space_idstring required

Space ID for UI operations

space_tenant_idstring required

Weaviate tenant ID for this space

rolestring required

User's role: owner, editor, viewer

created_atstring date-time required

Creation timestamp

last_accessedstring date-time nullable

Last access timestamp

memory_countinteger

Number of memories in this space

shared_withstring[]

User IDs this space is shared with

collection_namestring

Weaviate collection: Memory or MemoryMultimodal

Example response

{
  "collection_name": "Memory",
  "color": "#4F46E5",
  "created_at": "2023-04-01T14:30:45.123Z",
  "icon": "💼",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "last_accessed": "2023-04-01T16:45:10.456Z",
  "memory_count": 42,
  "name": "Work Projects",
  "privacy_level": "personal",
  "role": "owner",
  "shared_with": [],
  "space_id": "space_12345678",
  "space_tenant_id": "space_work_abc12345",
  "space_type": "text_only",
  "template_type": "work"
}