Skip to main content
PUT
Write object

Authorizations

Authorization
string
header
required

API token from cargo-ai login. Send as Authorization: Bearer <token>.

Path Parameters

path
string
required

/-separated object path, e.g. reports/2026-q3/summary.pdf. Each segment is URL-encoded.

Minimum string length: 1

Query Parameters

contentType
string

MIME type of the object. The request itself is sent as application/octet-stream so no body parser touches the bytes. Defaults to application/octet-stream.

Minimum string length: 1
indexMode
enum<string>

none (default for a new object) only stores the bytes; vectorStore also makes them searchable by agents.

Available options:
none,
vectorStore
visibility
enum<string>

private (default) or public.

Available options:
private,
public
mirrorToContext
enum<string>

Also write the object under .files/ in the context repository. Defaults to false for a new object.

Available options:
true,
false

Response

Write object

file
File · object
required

The content file stored at this path.

path
string
required

The object's path.