TRtraversal
External API

Create or replace a knowledge file

Changed on

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}

Request

  • Base URL
    https://api.traversal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.traversal.com/v1/knowledge/files/{file_path}
  • Auth
    HTTP bearer

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