Write a file
Replaces one file with the raw request body (application/octet-stream, at most 100 MiB) and returns its new metadata. The body is streamed to the sandbox, never buffered whole. Requires files. Commands and file operations need an ACTIVE sandbox; on any other state they answer 409.
Authorizations
workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens
Headers
Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens - a workspace-owned token implies its workspace.
1 - 53"ws_j572abc123def456"
Path Parameters
Sandbox id (sbx_...).
^sbx_[A-Za-z0-9]{1,64}$"sbx_j572abc123def456"
Query Parameters
Absolute path inside the sandbox.
1 - 4096^\/[^\0]*$"/workspace/README.md"
Create missing directories. Default true.
Body
The body is of type file.
Response
SandboxFileInfo