Talkr AI
API ReferenceKnowledge BaseDocuments

Get a Document Upload URL

Get a presigned URL for uploading a document file, the first step of adding a document

Returns a presigned PUT URL (valid 30 minutes, 100MB max) plus a document_uuid. Upload the file directly to the returned URL, then call Process an Uploaded Document with the same document_uuid and s3_key to create the document record and trigger processing.

POST
/api/v1/knowledge-base/upload-url

Header Parameters

authorization?string|null
X-API-Key?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request schema for initiating document upload.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/knowledge-base/upload-url" \  -H "Content-Type: application/json" \  -d '{    "filename": "string",    "mime_type": "string"  }'
{  "upload_url": "string",  "document_uuid": "string",  "s3_key": "string"}