Agents Platform

Update File Document

Update the source file of a file document. The document name, content, and metadata are updated to reflect the new file. Any manual content edits will be overwritten.

patch/v1/convai/knowledge-base/{documentation_id}/update-file

Path parameters

documentation_idstring required

The id of a document from the knowledge base. This is returned on document addition.

Example:21m00Tcm4TlvDq8ikWAM

The id of a document from the knowledge base. This is returned on document addition.

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

Example response

{
  "access_info": {
    "access_source": "creator",
    "creator_email": "john.doe@example.com",
    "creator_name": "John Doe",
    "is_creator": true,
    "role": "admin"
  }
}

Changes

Changed in 1 of the 26 revisions of this API.3

Jul 26, 2026494d96419d153See the full diff
- ○
  added the optional property oneOf[subschema #2: GetKnowledgeBaseFileResponseModel]/auto_sync_info to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property oneOf[subschema #2: GetKnowledgeBaseFileResponseModel]/refresh_status to the response with the 200 status
  response-optional-property-added
- ○
  added the required property oneOf[subschema #4: GetKnowledgeBaseFolderResponseModel]/document_count to the response with the 200 status
  response-required-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history