Skip to main content
POST
A collection belongs to your organization. Collection names are unique within an organization, so creating a second collection with a name you already use returns 409. The embedding model and vector width are fixed when the collection is created and can never be changed afterwards, because vectors from two models cannot be compared. Omit both fields to use your deployment’s default embedding. Two collections with different embeddings cannot be combined behind one assistant. Creating a collection requires a role that can manage knowledge. A read-only member receives 403. See Organizations and roles.
string
required
Display name, at most 200 characters. Leading and trailing whitespace is trimmed, and a name that is empty after trimming is refused.
string
default:""
Free-text description. Requests over 4,000 characters are refused. The stored value is trimmed and truncated to 1,000 characters.
string
Embedding model for this collection. Omit it, or send an empty string, to use the deployment’s default.
integer
Vector width the embedding model produces. A positive integer, at most 100,000. Omit it to use the deployment’s default.

Response

Returns 201 with the new collection.
string
required
Collection ID (a UUID). Pass it as collection_id to other knowledge endpoints and to an assistant’s knowledge_base_ids.
string
required
The trimmed name.
string
required
The stored description. Empty string when none was given.
string
required
active for a new collection. See Update a collection for archived.
string
required
The embedding model the collection was created with.
integer
required
The vector width the collection was created with.
string
required
When the collection was created, ISO 8601 in UTC.
string
required
When the collection was last changed, ISO 8601 in UTC.
Last modified on September 26, 2026