Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Body

application/json
file_name
string
required

Name of the file to upload, including its extension.

file_size
integer
required

Size of the file in bytes.

category
enum<string>

Optional. If it is not set, the category is inferred from the file. A .zip file is always categorized as repository even when documentation is requested.

Available options:
repository,
documentation

Response

Signed upload target.

upload_id
string<uuid>
required
signed_url
string
required

PUT the file bytes here.

token
string
required
storage_path
string
required
file_type
string
required
resumable
object

Present only for large files that should use the resumable (TUS) protocol.