Batch Update

Update multiple existing documents with new content and metadata.

Use this endpoint when you need to replace or modify several documents that are already in your knowledge base. Each file must correspond to an existing source ID, ensuring that updates are applied to the correct documents.

The system processes updates asynchronously, allowing you to continue working while your documents are re-indexed. Track the progress using the returned file IDs to know when updates are complete.

Hit the Try it button to try this API now in our playground. It’s the best way to check the full request and response in one place, customize your parameters, and generate ready-to-use code snippets.

Examples

API Request

curl --request PATCH \
  --url 'https://api.usecortex.ai/upload/batch_update?tenant_id=tenant_1234&sub_tenant_id=sub_tenant_4567' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: multipart/form-data' \
  --form files=@example-file \
  --form 'source_ids=[
  "<string>"
]' \
  --form 'tenant_metadata={}' \
  --form 'document_metadata={}'

Update multiple sources in bulk, creating new entries for any source_id that doesn’t exist (upsert operation).

Provide one source_id per file. The number of source_ids must match the number of files.

Error Responses

All endpoints return consistent error responses following the standard format. For detailed error information, see our Error Responses documentation.

Authorizations

Authorization · string · header · required

Query Parameters

tenant_id · string · required

Example:

sub_tenant_id · string · default: ""

Example:

Body

multipart/form-data

files · file[] · required

source_ids · string[] | null

Example:

tenant_metadata · string | null · default: {}

document_metadata · string | null · default: {}

Response

200

application/json

uploaded · FileUploadResult · object[] · required

Show child attributes

Example:

message · string · required

success · boolean · default: true

Example: