latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-201,3412,1385.0 MB

3fdc16374d70

AI Collections

Add a collection source

Attaches a new content source to the specified collection and returns the created source. The source's content is ingested and embedded so it becomes searchable within the collection.

post/ai/collections/{uuid}/sources

Path parameters

uuidstring uuid required
Example:6a09ccbd-8f9b-4c3a-9b0e-2f1d3c4b5a6e

The collection's unique identifier.

Request body

bucket_idstring

The Telnyx Storage bucket name. Required when source_type is bucket; ignored otherwise.

source_type'voice' | 'meeting_bot' | 'message' | 'bucket' required

The type of Telnyx data attached as a source. bucket requires an additional bucket_id. Only voice is searchable today; meeting_bot, message, and bucket attach but are not yet searchable (Coming soon).

Example request

{
  "bucket_id": "policy-docs",
  "source_type": "voice"
}

Response

The created source.

Example response

{
  "data": {
    "bucket_id": "policy-docs",
    "collection_id": "6a09ccbd-8f9b-4c3a-9b0e-2f1d3c4b5a6e",
    "id": "source_8vkvtcksnawvbnxq48yv2l06wx",
    "record_type": "ai_collection_source",
    "source_type": "voice",
    "status": "ready"
  }
}