API ReferenceCollections

Get Collection

Retrieve details of a specific collection by its readable ID. Returns the complete collection configuration including sync settings, status, and metadata. Use this to check the current state of a collection or to get configuration details before making updates.

Authentication

x-api-keystring
API Key authentication via header

Path parameters

readable_idstringRequired

The unique readable identifier of the collection (e.g., ‘finance-data-ab123’)

Response

Collection details
namestring

Human-readable display name for the collection.

readable_idstring

URL-safe unique identifier used in API endpoints. This becomes non-optional once the collection is created.

idstringformat: "uuid"
Unique system identifier for the collection. This UUID is generated automatically and used for internal references.
vector_sizeinteger

Vector dimensions used by this collection. Determines which embedding model is used: 3072 (text-embedding-3-large), 1536 (text-embedding-3-small), 1024 (mistral-embed), or 384 (MiniLM-L6-v2).

embedding_model_namestring

Name of the embedding model used for this collection (e.g., ‘text-embedding-3-large’, ‘text-embedding-3-small’, ‘mistral-embed’). This ensures queries use the same model as the indexed data.

created_atstringformat: "date-time"

Timestamp when the collection was created (ISO 8601 format).

modified_atstringformat: "date-time"

Timestamp when the collection was last modified (ISO 8601 format).

organization_idstringformat: "uuid"
Identifier of the organization that owns this collection. Collections are isolated per organization.
sync_configobject or null
Default sync configuration for all syncs in this collection. Overridable at sync and job level.
created_by_emailstring or nullformat: "email"
Email address of the user who created this collection.
modified_by_emailstring or nullformat: "email"
Email address of the user who last modified this collection.
statusenum or null
Current operational status of the collection:<br/>• **NEEDS_SOURCE**: Collection has no authenticated connections, or connections exist but haven't synced yet<br/>• **ACTIVE**: At least one connection has completed a sync or is currently syncing<br/>• **ERROR**: All connections have failed their last sync
Allowed values:

Errors