AI Collections
Update a collection
Updates a collection's metadata (name and/or description). Sources and settings are managed through their own sub-resources.
patch/ai/collections/{uuid}
Path parameters
uuidstring uuid required
Example:6a09ccbd-8f9b-4c3a-9b0e-2f1d3c4b5a6e
The collection's unique identifier.
Request body
Example request
{
"description": "Updated description.",
"name": "Support Transcripts (2026)"
}Response
The updated collection.
Example response
{
"data": {
"created_at": "2026-08-04T12:00:00Z",
"description": "All customer support voice transcripts.",
"name": "Support Transcripts",
"record_type": "ai_collection",
"settings": {
"record_type": "ai_collection_settings",
"retrieval": {
"retrieval_type": "vector",
"top_k": 5
}
},
"slug": "support-transcripts",
"sources": [
{
"bucket_id": "policy-docs",
"collection_id": "6a09ccbd-8f9b-4c3a-9b0e-2f1d3c4b5a6e",
"id": "source_8vkvtcksnawvbnxq48yv2l06wx",
"record_type": "ai_collection_source",
"source_type": "voice",
"status": "ready"
}
],
"status": "ready",
"updated_at": "2026-08-04T12:00:00Z",
"uuid": "6a09ccbd-8f9b-4c3a-9b0e-2f1d3c4b5a6e"
}
}