Sign in
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

namestring
descriptionstring

Example request

{
  "name": "Support Transcripts (2026)",
  "description": "Updated description."
}

Response

The updated collection.

Example response

{
  "data": {
    "uuid": "6a09ccbd-8f9b-4c3a-9b0e-2f1d3c4b5a6e",
    "slug": "support-transcripts",
    "record_type": "ai_collection",
    "name": "Support Transcripts",
    "description": "All customer support voice transcripts.",
    "status": "ready",
    "sources": [
      {
        "id": "source_8vkvtcksnawvbnxq48yv2l06wx",
        "record_type": "ai_collection_source",
        "collection_id": "6a09ccbd-8f9b-4c3a-9b0e-2f1d3c4b5a6e",
        "source_type": "voice",
        "bucket_id": "policy-docs",
        "status": "ready"
      }
    ],
    "settings": {
      "record_type": "ai_collection_settings",
      "retrieval": {
        "top_k": 5,
        "retrieval_type": "vector"
      }
    },
    "created_at": "2026-08-04T12:00:00Z",
    "updated_at": "2026-08-04T12:00:00Z"
  }
}

Changes

Changed in 2 of the 99 revisions of this API.3311

  • a6a61a29ecdd3310See the full diff
    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    • ▲

      the // response's property type changed from string to integer, and format from no format to int32 for status

      response-property-type-changed

    • ●

      removed the optional property /// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property /// from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property /// from the response with the status

      response-optional-property-removed

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      the response property // became required for the status

      response-property-became-required

    • ○

      removed the keyword enum value from the /// response property for the response status

      response-property-enum-value-removed

    This revision also has 34 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1571b0380bd71See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 64 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 99 revisions, 1 has no diff computed.