Sources

Sources are the data inputs a collection searches across. Each source type has its own page covering what it indexes and how to enable the underlying data:

Source type	What it indexes
`voice`	Voice call transcriptions for the account
`meeting_bot` Coming soon	Meeting transcriptions for the account
`message` Coming soon	Messaging history for the account
`bucket` Coming soon	Files in one specific Telnyx Storage bucket

Sources are managed through dedicated endpoints — never through collection PATCH (which would be ambiguous about intent). When a source is added, the resource is created with status set to ready and its content is indexed for search.

Add One Source

POST /v2/ai/collections/{uuid}/sources adds a single source without touching the others.

# Add a voice source
curl -X POST https://api.telnyx.com/v2/ai/collections/b3b1c8a2-9f4e-4d2a-9c1e-2f7a6d5b4c3a/sources \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "source_type": "voice" }'

{
  "data": {
    "id": "source_8vkvtcksnawvbnxq48yv2l06wx",
    "record_type": "ai_collection_source",
    "collection_id": "b3b1c8a2-9f4e-4d2a-9c1e-2f7a6d5b4c3a",
    "source_type": "voice",
    "status": "ready"
  }
}

Returns 201 Created with the new source object.

Replace All Sources

PUT /v2/ai/collections/{uuid}/sources replaces the complete source list. The server reconciles by logical identity:

voice — by source_type

Retained sources are not reindexed. Dropped sources are detached from this collection only — replacing the list never starts physical cleanup of chunks, embeddings, or metadata, and never deletes the underlying Telnyx product data.

curl -X PUT https://api.telnyx.com/v2/ai/collections/b3b1c8a2-9f4e-4d2a-9c1e-2f7a6d5b4c3a/sources \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sources": [
      { "source_type": "voice" }
    ]
  }'

{
  "data": [
    { "id": "source_8vkvtcksnawvbnxq48yv2l06wx", "record_type": "ai_collection_source",
      "collection_id": "b3b1c8a2-9f4e-4d2a-9c1e-2f7a6d5b4c3a", "source_type": "voice", "status": "ready" }
  ],
  "meta": {
    "added":    [],
    "retained": [ "source_8vkvtcksnawvbnxq48yv2l06wx" ],
    "removed":  [ "source_8atnodb2vjqlpqwm211lwo739w" ]
  }
}

List Sources

curl -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/ai/collections/b3b1c8a2-9f4e-4d2a-9c1e-2f7a6d5b4c3a/sources"

{
  "data": [
    { "id": "source_8vkvtcksnawvbnxq48yv2l06wx", "record_type": "ai_collection_source",
      "collection_id": "b3b1c8a2-9f4e-4d2a-9c1e-2f7a6d5b4c3a",
      "source_type": "voice", "status": "ready" }
  ]
}

Remove One Source

DELETE /v2/ai/collections/{uuid}/sources/{source_id} removes a single source; the rest are untouched. Excluded from new searches immediately — this detaches the collection’s pointer to the source only. A source can back many collections, so detaching never starts physical cleanup of chunks, embeddings, or metadata. Never deletes the original Telnyx product data. Never disables a bucket or credential connection.

curl -X DELETE -H "Authorization: Bearer $TELNYX_API_KEY" \
  "https://api.telnyx.com/v2/ai/collections/b3b1c8a2-9f4e-4d2a-9c1e-2f7a6d5b4c3a/sources/source_8vkvtcksnawvbnxq48yv2l06wx"

Returns 204 No Content — no body.

Collections — create, list, retrieve, update, and delete collections
Settings — configure retrieval type and top_k

Search

Concepts

Configuration

API

For AI Agents

Add One Source

Replace All Sources

List Sources

Remove One Source

​Add One Source

​Replace All Sources

​List Sources

​Remove One Source

​Related

Add One Source

Replace All Sources

List Sources

Remove One Source

Related