AI Collections

List collections

Returns a paginated list of collections in your organization.

get/ai/collections

Query parameters

page[number]integer
Example:1

Page number to return (1-based). Defaults to 1.

page[size]integer
Example:20

Number of results per page. Defaults to 20.

Response

A paginated list of collections.

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"
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 42,
    "page_number": 1,
    "page_size": 20
  }
}

Changes

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

  • a6a61a29ecdd114See 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

    • ●

      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

    • ○

      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

    • ○

      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.