Initiate File Uploads

Generates presigned URLs and creates upload records for one or more files. Use this endpoint to prepare files for upload to the knowledge base.

Workflow: After receiving the presigned URLs, upload the files directly to the provided URLs, then use the Add Knowledge Base Files endpoint to associate them with an agent.

POST /ai-agents/agent-builder/knowledge-base/uploads/initiate

Initiate File Uploads

cURL

curl --request POST \
  --url https://{appid}.api-{region}.cometchat.io/v3/ai-agents/agent-builder/knowledge-base/uploads/initiate \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "files": [
    {
      "fileName": "document.pdf",
      "mimeType": "application/pdf",
      "fileSize": 1024000
    },
    {
      "fileName": "document_2.pdf",
      "mimeType": "application/pdf",
      "fileSize": 512000
    }
  ]
}
'

200

{
  "uploads": [
    {
      "uploadId": "550e8400-e29b-41d4-a716-446655440000",
      "fileName": "document.pdf",
      "mimeType": "application/pdf",
      "fileSize": 1024000,
      "s3Key": "my-app-id/uploads/550e8400/document.pdf",
      "presignedUrl": "https://s3.amazonaws.com/bucket/..."
    }
  ]
}

Authorizations

apikey · string · header · required

API Key (i.e. Rest API Key from the Dashboard).

Body

application/json

files · object[] · required

List of files to upload

Show child attributes

Response

200 - application/json

Presigned URLs generated and upload records created successfully

uploads · object[]

Show child attributes