External API

Create or replace a knowledge file

Send the file bytes as the request body. Set Content-Type to match the file extension, or use application/octet-stream to infer it. The maximum file size is 10 MB.

put/v1/knowledge/files/{file_path}

Path parameters

file_pathstring required

Headers

If-Matchstring nullable
If-None-Matchstring nullable

Request body

string binary required

Response

The existing file was replaced.

pathstring required

POSIX path under user_generated/ or skills/.

content_typestring required

Stored content type.

size_bytesinteger required

File size in bytes.

sha256string required

Hex SHA-256 of the file bytes.

etagstring required

Opaque version token for conditional requests.

created_atstring date-time required
updated_atstring date-time required
createdboolean required

True when the path did not already exist.

Changes