Skip to main content
POST
Create Collection

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Body for creating a collection.

model
string
required

Model string the collection binds to, as 'feature/subfeature/provider' (e.g. 'image/face_recognition/amazon'). Fixed at creation: item operations and /v3/universal-ai calls against this collection all run on that provider.

Minimum string length: 1
name
string | null

Optional human-readable name for the collection.

Maximum string length: 255

Response

Successful Response

A collection owned by the authenticated user.

collection_id
string<uuid>
required

Client-facing collection id; use it in item operations and in /v3/universal-ai calls that take a collection_id input.

model
string
required

'feature/subfeature/provider' string the collection is bound to.

name
string | null

Collection name, if any.