Docs - AI phone agents for SMB

curl -X POST https://api.telzino.com/v1/knowledge-sources/22222222-2222-2222-2222-222222222222/enqueue \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "33333333-3333-3333-3333-333333333333",
    "forceReindex": false
  }'

{ "success": true }

POST

knowledge-sources

{sourceId}

reingest

curl -X POST https://api.telzino.com/v1/knowledge-sources/22222222-2222-2222-2222-222222222222/enqueue \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "33333333-3333-3333-3333-333333333333",
    "forceReindex": false
  }'

{ "success": true }

Path Parameters

string

required

Knowledge source ID (UUID).

Enqueue File Ingestion

After creating a file source and uploading the file to its presigned URL, enqueue ingestion: POST /v1/knowledge-sources/{sourceId}/enqueue

string

required

The jobId returned when you created the file source. It must belong to this source — a mismatched or unknown jobId returns 400 invalid_request.

boolean

Rebuild the source even if it was previously ingested.

curl -X POST https://api.telzino.com/v1/knowledge-sources/22222222-2222-2222-2222-222222222222/enqueue \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "33333333-3333-3333-3333-333333333333",
    "forceReindex": false
  }'

{ "success": true }

Re-ingest a Source

Re-ingesting creates a new ingestion job and rebuilds the source’s vectors. POST /v1/knowledge-sources/{sourceId}/reingest

curl -X POST https://api.telzino.com/v1/knowledge-sources/22222222-2222-2222-2222-222222222222/reingest \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": {
    "jobId": "33333333-3333-3333-3333-333333333333"
  }
}

Download a Source File

GET /v1/knowledge-sources/{sourceId}/download Returns a short-lived presigned URL for the source’s original uploaded file. GET that URL to retrieve the bytes — it carries the original filename, so a browser saves it under the name it was uploaded with rather than the internal storage key. Only file sources can be downloaded. A URL source returns 400 invalid_request; its address is already available in the url field from List Sources. The URL expires after expiresIn seconds — request a new one rather than storing it.

curl https://api.telzino.com/v1/knowledge-sources/22222222-2222-2222-2222-222222222222/download \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

curl -o guide.pdf "URL_FROM_RESPONSE"

{
  "data": {
    "url": "https://s3.amazonaws.com/...",
    "fileName": "guide.pdf",
    "fileMime": "application/pdf",
    "expiresIn": 300
  }
}

{
  "error": "invalid_request",
  "error_description": "Only file sources can be downloaded. URL sources expose their address in the `url` field."
}

Delete a Source

DELETE /v1/knowledge-sources/{sourceId} Deletes the source row, related storage objects, and enqueues worker-side vector deletion.

curl -X DELETE https://api.telzino.com/v1/knowledge-sources/22222222-2222-2222-2222-222222222222 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{ "success": true }

API Reference

Agents

Places

MCP

Knowledge Bases

Guardrails

Email Servers

Voices

Custom Voices

STT Providers

LLM Models

Call Logs

Outbound Calls

Metrics

Reports

Resellers

Organizations

Sessions

Billing

Payments

Source Actions

Path Parameters

Enqueue File Ingestion

Re-ingest a Source

Download a Source File

Delete a Source

​Path Parameters

​Enqueue File Ingestion

​Re-ingest a Source

​Download a Source File

​Delete a Source

Path Parameters

Enqueue File Ingestion

Re-ingest a Source

Download a Source File

Delete a Source