Write workspace file bytes
PUT/api/box/v1/{boxId}/workspace/file
Requires an active, authorized Box and a completed restore. Sandbox requires an explicitly started running lease; file access never allocates or wakes a VM. Paths are canonical under /workspace; symbolic links are rejected. Workspace capacity is 256 MiB; writes are limited to 16 MiB per request. A failed transport acknowledgement does not prove the write did not happen; read the path before deciding to resend.
Organization API key authentication
Authorization: Bearer $SINECLOUD_API_KEYRequired scopes: fileWrite
Parameters
boxId· path · Required- Existing Box resource ID selected in Console, not its parent product activation ID.
path· query · Required- Required canonical path below /workspace; /workspace itself is not a file.
Request body
Required
Raw file contents, at most 16 MiB.
application/octet-stream
Responses
200- Written file path and byte size.
400- Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.
401- Missing, invalid, expired or revoked organization credential.
403- Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.
404- Resource, execution, snapshot, restore or file not found within the authorized organization.
409- State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.
413- File body exceeds 16,777,216 bytes.
500- The request could not be completed. Preserve any durable identity before retrying.
503- Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.