Skip to main content
POST
Create a collection

Authorizations

Authorization
string
header
required

User session JWT. Send as Authorization: Bearer <token>.

Body

application/json
name
string
required

Collection name (alphanumeric, -, _). Unique per owner.

Maximum string length: 64
Pattern: ^[a-zA-Z0-9_-]+$
Example:

"products"

description
string

Human-readable description, also visible to agents.

Example:

"Product catalog, one row per SKU, prices in EUR"

settings
object
properties
object

Column definitions: field name → type descriptor.

Example:

Response

Collection created.

collection_id
string<uuid>
name
string
owner_id
string
owner_type
enum<string>
Available options:
user,
agent
status
string
Example:

"ready"

schema_applied
boolean