curl --request POST \
--url https://embed.breadbowl.ai/v1/indexes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "production",
"text_retention": "none"
}
'{
"id": "739c40ce-fa7e-4ba1-bcc2-46632fd13088",
"name": "production",
"model": "breadbowl-embed-alpha",
"model_version": "version-2026-07",
"text_retention": "none",
"chunking": {
"strategy": "token_window",
"max_tokens": 384,
"overlap_tokens": 64,
"minimum_chunk_tokens": 32
},
"metadata_schema": {},
"status": "ready",
"created_at": "2026-07-15T16:27:28.765Z"
}Create an index
Creates a tenant-scoped index. Names are unique within a tenant. The returned model version is immutable for that index; create and reingest into a new index when moving to another version.
Omit model unless the BreadBowl Embed team has explicitly instructed you to select a supported model.
POST
/
v1
/
indexes
curl --request POST \
--url https://embed.breadbowl.ai/v1/indexes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "production",
"text_retention": "none"
}
'{
"id": "739c40ce-fa7e-4ba1-bcc2-46632fd13088",
"name": "production",
"model": "breadbowl-embed-alpha",
"model_version": "version-2026-07",
"text_retention": "none",
"chunking": {
"strategy": "token_window",
"max_tokens": 384,
"overlap_tokens": 64,
"minimum_chunk_tokens": 32
},
"metadata_schema": {},
"status": "ready",
"created_at": "2026-07-15T16:27:28.765Z"
}Authorizations
Tenant-scoped API key beginning with qkv_live_.
Body
application/json
Human-readable name unique within the authenticated tenant.
Minimum string length:
1Optional supported model name. Omit unless instructed during onboarding.
Minimum string length:
1Available options:
none Show child attributes
Show child attributes
Descriptive customer metadata schema recorded with the index.
Response
Index created
Minimum string length:
1Minimum string length:
1Immutable serving version for this index.
Minimum string length:
1Available options:
none Show child attributes
Show child attributes
Available options:
creating, ready, error