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 }
Knowledge Bases
Source Actions
Enqueue, re-ingest, or delete knowledge base sources
POST
/
v1
/
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. A URL source is re-fetched from its live page, so edits made since the last run are picked up. A file source is re-processed from the copy already stored for it, which does not change — to pick up an edited document use Replace a Source File. To rebuild every source at once, see Re-index a Knowledge Base.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 }