Skip to main content
POST
Mints a short-lived presigned PUT URL for uploading a file to a draft directive’s content. The client hashes the file locally, calls this endpoint with the digest and size, then PUTs directly to the returned URL. Large payloads never traverse the backend. Required scope: context:write

Path Parameters

string
required
The directive ID (must be a draft). Example: dir_abc123.

Headers

string
required
Bearer token. Example: Bearer runtm_xxx
string
Scope to an organization.

Body

string
required
File path within the skill bundle (1–512 chars). Example: SKILL.md.
string
required
Lowercase hex SHA-256 digest of the file (exactly 64 characters).
integer
required
File size in bytes (must be > 0).

Response

string
Presigned PUT URL. Upload the file body directly with a PUT request.
string
Content-addressed reference (sha256:<hex>) to use when patching the directive’s file entry.
string
ISO 8601 timestamp when the presigned URL expires.