AimableDocs
DocsAPI ReferenceRelease Notes
POST/v1/spaces/{space_id}/collections

Create Space Collection

Create a curated, space-visible collection with a server-generated UUID. The generated collection_id is used consistently as: - The DB primary key for collection.id - The filesystem folder name under knowledge_uploads/{collection_id} - The logical collection identifier in the vector store.

Path Parameters

NameTypeRequiredDescription
space_idstring (uuid)Required

Headers

NameTypeRequiredDescription
X-API-KeystringOptional

Request Body

application/json
bodyobjectRequired
Authentication
X-API-Key: ak.<key_id>.<secret>Authentication & errors →

Request

curl -X POST '/api/v1/spaces/{space_id}/collections' \
  -H 'X-API-Key: ak.<key_id>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response

201

No response body documented

Error Responses