{"openapi":"3.0.3","info":{"title":"Sine Box API","version":"1.0.0","description":"Cloud customer HTTP contract for Lite and Sandbox Boxes. First use Console to activate the product, select an eligible runtime profile, create/list Box resources, configure network ceilings and issue an organization API key with sine-box grants. Resource creation/listing and resource lifecycle inspection/pause/resume/destruction require a Console session; restore initiation and backup deletion require a current manager session. These are not Bearer API operations. Use an actual Box resource ID, never the parent activation ID. Keys are checked against current issuer membership, product scopes, project ownership, resource access and admission/funding conditions. Lite supports commands up to 120 seconds; Sandbox supports explicitly funded windows up to 30 minutes and commands up to 5 minutes. Workspace capacity is 256 MiB with 16 MiB individual uploads. Runtime reads/files never automatically resume a VM. Keep durable execution/lease/request identities after network failures; reconciliation/unknown is not a replay permission. Native file/result payloads are preserved; errors, binary downloads and per-runtime billing projections are documented on their operations."},"servers":[{"url":"https://sinecloud.dev"}],"tags":[{"name":"Box workspace"},{"name":"Box executions"},{"name":"Box runtime"},{"name":"Box backups"}],"x-sinecloud-source":{"repository":"sine-box","revision":"f000f55c56cf05f0763eba5121c2ccd4eb1b680c","sourcePath":"apps/api/src/openapi.ts","sourceSha256":"815119be1f83aa5197d114fd6dbc77ef6c8692adf2430f2fb876f6b0cb5c7e57","snapshotSha256":"b615b8b33236351d9f2792a53df6fbe7a7c3cc78ead14d88ec91ec9119e5248c"},"paths":{"/api/box/v1":{"get":{"operationId":"boxListBoxes","summary":"List Box resources","description":"Lists Box resources the key can see in its organization and optional project scope. Cloud owns the directory, lifecycle and pagination; runtime fields come from the sine-box catalog when the private binding is configured and never trigger a provider call. Retired resources remain visible until removed, so filter on state.","tags":["Box resources"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Box resource page.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxCollection"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum resources per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"description":"Unmodified nextCursor from the previous page.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,512}$"}}]}},"/api/box/v1/{boxId}/workspace/files":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."}],"get":{"operationId":"boxListWorkspaceFiles","summary":"List workspace directory","description":"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. Opaque cursors are runtime-owned and directory changes can invalidate them.","tags":["Box workspace"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Directory page with native snake_case file metadata.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilePage"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}}},"parameters":[{"name":"path","in":"query","required":true,"description":"Required canonical directory path; explicitly send /workspace for the root.","schema":{"type":"string","maxLength":1024,"description":"Canonical absolute /workspace path. Rejects traversal, trailing slash, duplicate separators, backslashes, control characters and symlinks."}},{"name":"limit","in":"query","required":false,"description":"Maximum entries per page.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"cursor","in":"query","required":false,"description":"Unmodified nextCursor from the previous page.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,4096}$"}}]}},"/api/box/v1/{boxId}/workspace/stats":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."}],"get":{"operationId":"boxGetWorkspaceStats","summary":"Read workspace statistics","description":"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.","tags":["Box workspace"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Directory descendant counts and runtime-declared capacity.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}}},"parameters":[{"name":"path","in":"query","required":true,"description":"Required canonical directory path; explicitly send /workspace for the root.","schema":{"type":"string","maxLength":1024,"description":"Canonical absolute /workspace path. Rejects traversal, trailing slash, duplicate separators, backslashes, control characters and symlinks."}}]}},"/api/box/v1/{boxId}/workspace/file":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."}],"get":{"operationId":"boxReadWorkspaceFile","summary":"Read workspace file bytes","description":"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.","tags":["Box workspace"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Native file bytes.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}}},"parameters":[{"name":"path","in":"query","required":true,"description":"Required canonical path below /workspace; /workspace itself is not a file.","schema":{"type":"string","maxLength":1024,"description":"Canonical absolute /workspace path. Rejects traversal, trailing slash, duplicate separators, backslashes, control characters and symlinks."}}]},"put":{"operationId":"boxWriteWorkspaceFile","summary":"Write workspace file bytes","description":"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.","tags":["Box workspace"],"x-sinecloud-scopes":["fileWrite"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Written file path and byte size.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileWrite"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"413":{"description":"File body exceeds 16,777,216 bytes.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}}},"parameters":[{"name":"path","in":"query","required":true,"description":"Required canonical path below /workspace; /workspace itself is not a file.","schema":{"type":"string","maxLength":1024,"description":"Canonical absolute /workspace path. Rejects traversal, trailing slash, duplicate separators, backslashes, control characters and symlinks."}}],"requestBody":{"required":true,"description":"Raw file contents, at most 16 MiB.","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}},"delete":{"operationId":"boxDeleteWorkspaceFile","summary":"Delete workspace file","description":"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.","tags":["Box workspace"],"x-sinecloud-scopes":["fileWrite"],"security":[{"OrganizationApiKey":[]}],"responses":{"204":{"description":"File deleted; no response body.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceError"}}}}},"parameters":[{"name":"path","in":"query","required":true,"description":"Required canonical path below /workspace; /workspace itself is not a file.","schema":{"type":"string","maxLength":1024,"description":"Canonical absolute /workspace path. Rejects traversal, trailing slash, duplicate separators, backslashes, control characters and symlinks."}}]}},"/api/box/v1/{boxId}/executions":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."}],"get":{"operationId":"boxListExecutions","summary":"List execution history","description":"Reads saved metadata without contacting the runtime or resuming a paused Box. Results sort newest first by creation time and ID. Sandbox lists commands, not lease reservations; its command history reserved/charged fields are zero because billing belongs to the lease. Command text, environment and output are available only through applicable detail responses. Keep filters unchanged when using nextCursor.","tags":["Box executions"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Metadata page.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionHistory"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum records.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","required":false,"description":"Unmodified nextCursor; must belong to this filtered collection.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Exact saved status.","schema":{"type":"string","enum":["reserved","dispatching","running","reconciliation","settled","released"]}},{"name":"from","in":"query","required":false,"description":"Inclusive creation timestamp with timezone and at most millisecond precision.","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"description":"Exclusive creation timestamp; must be after from.","schema":{"type":"string","format":"date-time"}}]},"post":{"operationId":"boxSubmitExecution","summary":"Submit a durable command","description":"Send at most 1 MiB of JSON. The executionId identifies the exact original command, normalized environment, network and authority; changing input under the same identity conflicts. Retries inspect existing work and never replay an uncertain dispatch. Lite reserves credits against the maximum command duration and bills measured wall time (maximum 120 seconds). Sandbox requires a funded running lease with enough remaining time, caps commands at 300 seconds, and requires the lease network policy; it charges only allocated VM time at lease level. Successful HTTP status can contain nonzero exitCode, reconciliation or unavailable output. Preserve executionId and inspect status before any retry.","tags":["Box executions"],"x-sinecloud-scopes":["boxRun"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Current command result or durable in-progress/uncertain state.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionResponse"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"402":{"description":"Insufficient available organization credits for the reservation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"413":{"description":"JSON body exceeds its byte limit.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"415":{"description":"Use Content-Type: application/json.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"429":{"description":"Admission concurrency, rate or budget limit reached.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"Retry-After":{"description":"Retry delay when supplied by admission; preserve the original identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommandInput"}}}}}},"/api/box/v1/{boxId}/executions/{executionId}":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."},{"name":"executionId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing executionId in this Box."}],"get":{"operationId":"boxGetExecution","summary":"Read execution status and result","description":"Reads/reconciles the original durable identity, including paused resources. A saved terminal result can remain available during provider outages. Unknown or missing runtime acknowledgement stays reconciliation; it never authorizes a fresh command. Lite carries billing fields; Sandbox carries the original lease meter and optional outputAvailable.","tags":["Box executions"],"x-sinecloud-scopes":["boxRun"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Current execution projection.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionResponse"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}}}},"/api/box/v1/{boxId}/executions/{executionId}/cancel":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."},{"name":"executionId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing executionId in this Box."}],"post":{"operationId":"boxCancelExecution","summary":"Request command cancellation","description":"Cancellation preserves execution identity and does not undo external effects or manufacture an exit code. It may still return running/reconciliation until durable termination evidence exists. Sandbox cancellation fences the command without implicitly stopping its lease; explicitly stop the runtime window to stop allocation billing. Recovery remains available for inactive resources.","tags":["Box executions"],"x-sinecloud-scopes":["boxRun"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Observed execution after cancellation request.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionResponse"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}}}},"/api/box/v1/{boxId}/runtime":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."}],"get":{"operationId":"boxGetRuntime","summary":"Read runtime selection and lease","description":"Lite returns lease:null and billing:null. Sandbox observes the selected or latest existing lease and may reconcile real allocation evidence, but never starts/resumes a VM. Lease timestamps are epoch milliseconds. An expired timer is not proof of provider stop; unknown retains billing uncertainty. Reads support inactive resources.","tags":["Box runtime"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Runtime and current durable lease/billing projection.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeResponse"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"parameters":[{"name":"leaseId","in":"query","required":false,"description":"Optional existing lease identity; omitted selects a pending lease first, otherwise the most recent.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}}]},"post":{"operationId":"boxChangeRuntime","summary":"Start, extend or stop a Sandbox window","description":"Sandbox only; Lite returns runtimeConflict. start uses a caller-chosen immutable leaseId, default 600,000 ms and maximum 1,800,000 ms. Reusing the exact original request observes the same allocation; it does not resume a stopped window or replay uncertain creation. extend reserves the additional charge before requesting a greater TOTAL duration; requestId plus expectedTimeoutMs prevent duplicate extension or stale updates. Observe unknown extensions instead of creating replacement requests. stop requests provider pause/stop and retains an immutable paused receipt; it is safe to repeat and can recover an inactive resource. start/extend require active access. Runtime stop differs from Console-only resource lifecycle pause. There is no automatic resume or public inbound traffic.","tags":["Box runtime"],"x-sinecloud-scopes":["boxRun"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Observed lease, original billing and optional extension state/quote.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeResponse"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"402":{"description":"Insufficient available organization credits for the reservation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"413":{"description":"JSON body exceeds its byte limit.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"415":{"description":"Use Content-Type: application/json.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"429":{"description":"Admission concurrency, rate or budget limit reached.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"Retry-After":{"description":"Retry delay when supplied by admission; preserve the original identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/RuntimeStart"},{"$ref":"#/components/schemas/RuntimeExtend"},{"$ref":"#/components/schemas/RuntimeStop"}],"discriminator":{"propertyName":"action","mapping":{"start":"#/components/schemas/RuntimeStart","extend":"#/components/schemas/RuntimeExtend","stop":"#/components/schemas/RuntimeStop"}}}}}}}},"/api/box/v1/{boxId}/price":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."}],"get":{"operationId":"boxGetPrice","summary":"Read current Box profile price","description":"Reads the selected profile price without reserving credits. Lite measures wall_elapsed_ms; Sandbox measures allocated_vm_ms. Existing reservations retain their original price even if the current profile price changes. Current active fileRead access is required.","tags":["Box runtime"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Current price.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"price":{"$ref":"#/components/schemas/Price"}},"required":["price"]}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}}}},"/api/box/v1/{boxId}/backups":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."}],"get":{"operationId":"boxListBackups","summary":"List retained backup records","description":"Requires a current fileRead key and current issuer membership/project access. Retained backups can be read without a live VM or available wallet, including after runtime/entitlement inactivity. Only unexpired complete snapshots provide files, manifests and exports; retention follows the organization plan and expiresAt is authoritative. Lists all saved states, including deleted/failed records; newest first. latestConfirmedSnapshotAt is the latest complete record, not a promise that it remains unexpired.","tags":["Box backups"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Backup metadata page.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupPage"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum records.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"description":"Backup ID returned as nextCursor, scoped to this Box.","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}}]},"post":{"operationId":"boxCreateBackup","summary":"Request a managed Sandbox backup","description":"Sandbox only; Lite returns backupUnsupported. Admission requires active boxRun access and no nonterminal command; competing commands/snapshots can return backupBusy. Snapshot advancement also requires fileRead permission to observe an already funded running lease; it never starts a VM. At most 256 MiB and 20,000 entries. The UUID requestId is retained even after expiry/deletion and never resnapshots under the same identity. Authority/input changes conflict. HTTP 202 acknowledges durable workflow admission, not completed backup; poll the returned backup.id. Retention follows the organization plan, exposed as expiresAt. Snapshot and transfer may become failed or unknown and must not be assumed complete. A complete backup may report snapshotCleanupPending while temporary runtime cleanup finishes; its retained data is complete.","tags":["Box backups"],"x-sinecloud-scopes":["boxRun","fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"202":{"description":"Durable backup state after workflow advancement.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupResponse"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"413":{"description":"JSON body exceeds its byte limit.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"415":{"description":"Use Content-Type: application/json.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"}},"required":["requestId"],"additionalProperties":false}}}}}},"/api/box/v1/{boxId}/backups/{backupId}":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."},{"name":"backupId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing backupId in this Box."}],"get":{"operationId":"boxGetBackup","summary":"Read backup status and manifest","description":"Requires a current fileRead key and current issuer membership/project access. Retained backups can be read without a live VM or available wallet, including after runtime/entitlement inactivity. Only unexpired complete snapshots provide files, manifests and exports; retention follows the organization plan and expiresAt is authoritative. Non-complete records return backup metadata only. Complete retained records additionally return the verified manifest. An expired complete record returns backupUnavailable. Backup deletion requires a current manager Console session and is not a Key operation.","tags":["Box backups"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Backup status and optional complete snapshot manifest.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupDetail"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}}}},"/api/box/v1/{boxId}/backups/{backupId}/files":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."},{"name":"backupId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing backupId in this Box."}],"get":{"operationId":"boxListBackupFiles","summary":"List snapshot directory","description":"Requires a current fileRead key and current issuer membership/project access. Retained backups can be read without a live VM or available wallet, including after runtime/entitlement inactivity. Only unexpired complete snapshots provide files, manifests and exports; retention follows the organization plan and expiresAt is authoritative. Lists direct children from an immutable manifest, sorted by path.","tags":["Box backups"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Snapshot directory page.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackupFiles"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"parameters":[{"name":"path","in":"query","required":false,"description":"Directory in this snapshot.","schema":{"type":"string","description":"Canonical /workspace path, at most 4,096 UTF-8 bytes; no traversal, duplicate separators, backslashes or control characters.","default":"/workspace"}},{"name":"limit","in":"query","required":false,"description":"Maximum entries.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"description":"Unmodified nextCursor: an offset in the immutable directory listing.","schema":{"type":"string","pattern":"^\\d{1,8}$"}}]}},"/api/box/v1/{boxId}/backups/{backupId}/file":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."},{"name":"backupId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing backupId in this Box."}],"get":{"operationId":"boxReadBackupFile","summary":"Download snapshot file","description":"Requires a current fileRead key and current issuer membership/project access. Retained backups can be read without a live VM or available wallet, including after runtime/entitlement inactivity. Only unexpired complete snapshots provide files, manifests and exports; retention follows the organization plan and expiresAt is authoritative.","tags":["Box backups"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Verified retained snapshot file bytes.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"X-Sine-Box-Snapshot-At":{"schema":{"type":"string","format":"date-time"},"description":"Confirmed snapshot time; these are retained snapshot bytes, not live workspace bytes."},"Content-Disposition":{"schema":{"type":"string"},"description":"Attachment filename."},"Content-Security-Policy":{"schema":{"type":"string","enum":["default-src 'none'; sandbox"]}},"Content-Length":{"schema":{"type":"integer","minimum":0},"description":"Snapshot file size in bytes."}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}},"parameters":[{"name":"path","in":"query","required":true,"description":"Required file path in this snapshot.","schema":{"type":"string","description":"Canonical /workspace path, at most 4,096 UTF-8 bytes; no traversal, duplicate separators, backslashes or control characters."}}]}},"/api/box/v1/{boxId}/backups/{backupId}/export":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."},{"name":"backupId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing backupId in this Box."}],"get":{"operationId":"boxExportBackup","summary":"Export snapshot as a tar archive","description":"Requires a current fileRead key and current issuer membership/project access. Retained backups can be read without a live VM or available wallet, including after runtime/entitlement inactivity. Only unexpired complete snapshots provide files, manifests and exports; retention follows the organization plan and expiresAt is authoritative. Streams the retained verified snapshot as a tar attachment, not a live workspace archive.","tags":["Box backups"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Snapshot tar archive.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"X-Sine-Box-Snapshot-At":{"schema":{"type":"string","format":"date-time"},"description":"Confirmed snapshot time; these are retained snapshot bytes, not live workspace bytes."},"Content-Disposition":{"schema":{"type":"string"},"description":"Attachment filename."},"Content-Security-Policy":{"schema":{"type":"string","enum":["default-src 'none'; sandbox"]}}},"content":{"application/x-tar":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}}}},"/api/box/v1/{boxId}/restores/{restoreId}":{"parameters":[{"name":"boxId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing Box resource ID selected in Console, not its parent product activation ID."},{"name":"restoreId","in":"path","required":true,"schema":{"type":"string"},"description":"Existing restoreId in this Box."}],"get":{"operationId":"boxGetRestore","summary":"Read Console-initiated restore status","description":"Requires a current fileRead key and current issuer membership/project access. Retained backups can be read without a live VM or available wallet, including after runtime/entitlement inactivity. Only unexpired complete snapshots provide files, manifests and exports; retention follows the organization plan and expiresAt is authoritative. Restore initiation requires a current organization manager Console session. Read status using the original source boxId, not targetBoxId. Restore creates a distinct target Box with fresh execution/lease identities; it stays quarantined until verification completes. The target Box lifecycle state alone does not imply restore readiness. associationStatus is independent of restore completion; conflict does not make restored bytes invalid.","tags":["Box backups"],"x-sinecloud-scopes":["fileRead"],"security":[{"OrganizationApiKey":[]}],"responses":{"200":{"description":"Restore progress and safe target resource metadata.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestoreResponse"}}}},"400":{"description":"Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"401":{"description":"Missing, invalid, expired or revoked organization credential.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}},"WWW-Authenticate":{"schema":{"type":"string","enum":["Bearer"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"403":{"description":"Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"404":{"description":"Resource, execution, snapshot, restore or file not found within the authorized organization.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"409":{"description":"State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"500":{"description":"The request could not be completed. Preserve any durable identity before retrying.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}},"503":{"description":"Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.","headers":{"Cache-Control":{"schema":{"type":"string","enum":["no-store"]}},"X-Content-Type-Options":{"schema":{"type":"string","enum":["nosniff"]}},"x-request-id":{"description":"Request correlation ID; not an execution or idempotency identity.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloudError"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}},"FileEntry":{"type":"object","required":["name","size_bytes","is_file","is_directory","is_symbolic_link"],"properties":{"name":{"type":"string"},"size_bytes":{"type":"integer"},"is_file":{"type":"boolean"},"is_directory":{"type":"boolean"},"is_symbolic_link":{"type":"boolean"}}},"FilePage":{"type":"object","required":["path","entries","nextCursor"],"properties":{"path":{"type":"string"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/FileEntry"}},"nextCursor":{"type":"string","nullable":true}}},"Stats":{"type":"object","required":["files","directories","bytes"],"properties":{"files":{"type":"integer"},"directories":{"type":"integer"},"bytes":{"type":"integer"},"limits":{"oneOf":[{"type":"object","properties":{"logicalBytes":{"type":"integer","minimum":1},"inodes":{"type":"integer","minimum":1}},"required":["logicalBytes","inodes"]},{"type":"object","properties":{"diskBytes":{"type":"integer","minimum":1},"inodes":{"type":"integer","minimum":1}},"required":["diskBytes","inodes"]}]},"disk":{"type":"object","properties":{"totalBytes":{"type":"integer","minimum":1},"availableBytes":{"type":"integer","minimum":0}},"required":["totalBytes","availableBytes"]}},"description":"Runtime-reported workspace statistics. Lite uses logicalBytes; Sandbox may expose diskBytes and physical disk usage. Missing optional capacity is not zero."},"FileWrite":{"type":"object","required":["path","size_bytes"],"properties":{"path":{"type":"string"},"size_bytes":{"type":"integer"}}},"ExecutionResult":{"type":"object","required":["stdout","stderr","exitCode","durationMs"],"properties":{"stdout":{"type":"string"},"stderr":{"type":"string"},"exitCode":{"type":"integer"},"durationMs":{"type":"number"},"cancelled":{"type":"boolean"}}},"CloudError":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["authentication_error","invalid_request_error","server_error"]},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":"string","nullable":true,"enum":[null]}},"required":["type","code","message","param"]}},"required":["error"]},"WorkspaceError":{"oneOf":[{"$ref":"#/components/schemas/CloudError"},{"$ref":"#/components/schemas/Error"}],"description":"Admission errors use the structured Cloud error; sanitized runtime/transport failures retain the native string error."},"Network":{"oneOf":[{"type":"object","properties":{"access":{"type":"string","enum":["enabled","disabled"]},"allowed_domains":{"type":"array","maxItems":0,"items":{"type":"string"}}},"required":["access"],"additionalProperties":false},{"type":"object","properties":{"access":{"type":"string","enum":["restricted"]},"allowed_domains":{"type":"array","maxItems":256,"items":{"type":"string","maxLength":253,"pattern":"^[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?$"}}},"required":["access","allowed_domains"],"additionalProperties":false}],"description":"Requested egress intersects the Console-configured organization ceiling. Default disabled. Restricted domains reject consecutive dots and are normalized case-insensitively. Sandbox accepts enabled/disabled only and rejects a restricted effective ceiling."},"SandboxNetwork":{"type":"object","properties":{"access":{"type":"string","enum":["enabled","disabled"]},"allowed_domains":{"type":"array","maxItems":0,"items":{"type":"string"}}},"required":["access"],"additionalProperties":false},"CommandInput":{"type":"object","properties":{"executionId":{"type":"string","pattern":"^[A-Za-z0-9_-]{8,128}$","description":"Caller-generated durable command identity; Sandbox permits at most 100 characters, Lite 128. Never replace this identity to retry uncertain work."},"command":{"type":"string","minLength":1,"description":"Non-whitespace command, at most 65,536 UTF-8 bytes."},"cwd":{"type":"string","maxLength":1024,"description":"Canonical absolute /workspace path. Rejects traversal, trailing slash, duplicate separators, backslashes, control characters and symlinks.","default":"/workspace"},"env":{"type":"object","additionalProperties":{"type":"string"},"description":"Environment keys match ^[A-Za-z_][A-Za-z0-9_]*$. Serialized environment is limited to 65,536 UTF-8 bytes."},"timeoutMs":{"type":"integer","minimum":1,"maximum":300000,"default":30000,"description":"Lite maximum 120,000 ms; Sandbox maximum 300,000 ms and no longer than the remaining funded lease."},"network":{"$ref":"#/components/schemas/Network"}},"required":["executionId","command"],"additionalProperties":false},"Price":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"integer","minimum":0},"runtimeKind":{"type":"string","enum":["lite","sandbox"]},"creditsPerSecond":{"type":"string","description":"Decimal credits as a string; preserve precision."},"measurement":{"type":"string","enum":["allocated_vm_ms","wall_elapsed_ms"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","version","runtimeKind","creditsPerSecond","measurement","createdAt"]},"ExecutionBilling":{"type":"object","properties":{"id":{"type":"string"},"executionId":{"type":"string"},"instanceId":{"type":"string"},"boxId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["reserved","dispatching","running","reconciliation","settled","released"]},"version":{"type":"integer","minimum":0},"reason":{"type":"string","nullable":true},"result":{"anyOf":[{"$ref":"#/components/schemas/ExecutionResult"},{"type":"object","nullable":true,"enum":[null]}]},"reserved":{"type":"string","description":"Decimal credits as a string; preserve precision."},"charged":{"type":"string","description":"Decimal credits as a string; preserve precision.","nullable":true},"price":{"$ref":"#/components/schemas/Price"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","executionId","instanceId","boxId","organizationId","status","version","reason","result","reserved","charged","price","createdAt","updatedAt"],"description":"Lite command billing or Sandbox lease billing. Reconciliation preserves uncertainty and reserved funds; it is not permission to dispatch again. Settlement requires durable execution/allocation evidence."},"SandboxCommand":{"type":"object","properties":{"id":{"type":"string"},"executionId":{"type":"string"},"instanceId":{"type":"string"},"boxId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["running","settled","released","reconciliation"]},"version":{"type":"integer","minimum":0},"reason":{"type":"string","nullable":true},"result":{"anyOf":[{"$ref":"#/components/schemas/ExecutionResult"},{"type":"object","nullable":true,"enum":[null]}]},"outputAvailable":{"type":"boolean"},"metering":{"type":"object","properties":{"leaseId":{"type":"string"},"measurement":{"type":"string","enum":["allocated_vm_ms"]}},"required":["leaseId","measurement"]}},"required":["id","executionId","instanceId","boxId","organizationId","status","version","reason","result","metering"],"description":"Sandbox commands use the existing lease meter and do not reserve a second charge. outputAvailable may be absent while a receipt is unavailable; false with null result means output was not retained, not an empty successful result."},"ExecutionResponse":{"type":"object","properties":{"execution":{"oneOf":[{"$ref":"#/components/schemas/ExecutionBilling"},{"$ref":"#/components/schemas/SandboxCommand"}]}},"required":["execution"]},"ExecutionHistoryItem":{"type":"object","properties":{"id":{"type":"string"},"executionId":{"type":"string"},"instanceId":{"type":"string"},"boxId":{"type":"string"},"runtimeKind":{"type":"string","enum":["lite","sandbox"]},"organizationId":{"type":"string"},"businessProjectId":{"type":"string","nullable":true},"status":{"type":"string","enum":["reserved","dispatching","running","reconciliation","settled","released"]},"version":{"type":"integer","minimum":0},"reserved":{"type":"string","description":"Decimal credits as a string; preserve precision."},"charged":{"type":"string","description":"Decimal credits as a string; preserve precision.","nullable":true},"reason":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"kind":{"type":"string","enum":["command"]}},"required":["id","executionId","instanceId","boxId","runtimeKind","organizationId","businessProjectId","status","version","reserved","charged","reason","createdAt","updatedAt"]},"ExecutionHistory":{"type":"object","properties":{"executions":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionHistoryItem"}},"nextCursor":{"type":"string","nullable":true}},"required":["executions","nextCursor"]},"RuntimeSelection":{"type":"object","properties":{"kind":{"type":"string","enum":["lite","sandbox"]},"profile":{"type":"string","description":"Immutable Console-selected profile ID, not an arbitrary provider selector."}},"required":["kind","profile"]},"Lease":{"type":"object","properties":{"leaseId":{"type":"string"},"profile":{"type":"string","description":"Runtime profile recorded on this lease; may differ from the catalog profile ID in runtime.profile."},"state":{"type":"string","enum":["creating","running","paused","unknown"]},"startedAt":{"type":"integer","minimum":0,"nullable":true},"expiresAt":{"type":"integer","minimum":0,"nullable":true},"stoppedAt":{"type":"integer","minimum":0,"nullable":true},"durationMs":{"type":"integer","minimum":0,"nullable":true},"generation":{"type":"integer","minimum":1},"timeoutMs":{"type":"integer","minimum":1000},"version":{"type":"integer","minimum":1},"lastExtensionId":{"type":"string","nullable":true}},"required":["leaseId","profile","state","startedAt","expiresAt","stoppedAt","durationMs","generation","timeoutMs","version","lastExtensionId"]},"RuntimeResponse":{"type":"object","properties":{"runtime":{"$ref":"#/components/schemas/RuntimeSelection"},"lease":{"anyOf":[{"$ref":"#/components/schemas/Lease"},{"type":"object","nullable":true,"enum":[null]}]},"billing":{"anyOf":[{"$ref":"#/components/schemas/ExecutionBilling"},{"type":"object","nullable":true,"enum":[null]}]},"extensionQuote":{"type":"object","properties":{"expectedTimeoutMs":{"type":"integer","minimum":1000},"timeoutMs":{"type":"integer","minimum":1000},"additionalReserved":{"type":"string","description":"Decimal credits as a string; preserve precision."}},"required":["expectedTimeoutMs","timeoutMs","additionalReserved"],"nullable":true},"extension":{"type":"object","properties":{"requestId":{"type":"string"},"state":{"type":"string","enum":["accepted","rejected","unknown"]}},"required":["requestId","state"],"nullable":true}},"required":["runtime","lease","billing"]},"RuntimeStart":{"type":"object","properties":{"action":{"type":"string","enum":["start"]},"leaseId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"},"profile":{"type":"string","description":"Optional; must match this Box catalog profile."},"timeoutMs":{"type":"integer","minimum":1000,"maximum":1800000,"default":600000},"network":{"$ref":"#/components/schemas/SandboxNetwork"}},"required":["action","leaseId"],"additionalProperties":false},"RuntimeStop":{"type":"object","properties":{"action":{"type":"string","enum":["stop"]},"leaseId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"}},"required":["action","leaseId"],"additionalProperties":false},"RuntimeExtend":{"type":"object","properties":{"action":{"type":"string","enum":["extend"]},"leaseId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,100}$"},"requestId":{"type":"string","pattern":"^[A-Za-z0-9_-]{8,100}$"},"expectedTimeoutMs":{"type":"integer","minimum":1000},"timeoutMs":{"type":"integer","minimum":1001,"maximum":1800000,"description":"New TOTAL funded duration from the original lease start, strictly greater than expectedTimeoutMs. Never a duration from now."}},"required":["action","leaseId","requestId","expectedTimeoutMs","timeoutMs"],"additionalProperties":false},"Backup":{"type":"object","properties":{"id":{"type":"string"},"boxId":{"type":"string"},"status":{"type":"string","enum":["queued","snapshotting","transferring","complete","failed","unknown","deleting","deleted"]},"kind":{"type":"string","enum":["manual","daily"]},"createdAt":{"type":"string","format":"date-time"},"snapshotAt":{"type":"string","format":"date-time","nullable":true},"completedAt":{"type":"string","format":"date-time","nullable":true},"expiresAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"totalBytes":{"type":"integer","minimum":0},"transferredBytes":{"type":"integer","minimum":0},"entryCount":{"type":"integer","minimum":0},"errorCode":{"type":"string","nullable":true}},"required":["id","boxId","status","kind","createdAt","snapshotAt","completedAt","expiresAt","updatedAt","totalBytes","transferredBytes","entryCount","errorCode"]},"BackupEntry":{"type":"object","properties":{"path":{"type":"string"},"kind":{"type":"string","enum":["file","directory"]},"sizeBytes":{"type":"integer","minimum":0},"sha256":{"type":"string","nullable":true,"pattern":"^[a-f0-9]{64}$","description":"File SHA-256; null for directories."},"mode":{"type":"integer","minimum":0,"maximum":511}},"required":["path","kind","sizeBytes","sha256","mode"]},"BackupManifest":{"type":"object","properties":{"version":{"type":"integer","enum":[1]},"backupId":{"type":"string"},"createdAt":{"type":"integer","minimum":0,"description":"Unix epoch milliseconds."},"totalBytes":{"type":"integer","minimum":0,"maximum":268435456},"entries":{"type":"array","maxItems":20000,"items":{"$ref":"#/components/schemas/BackupEntry"}}},"required":["version","backupId","createdAt","totalBytes","entries"]},"BackupResponse":{"type":"object","properties":{"backup":{"$ref":"#/components/schemas/Backup"}},"required":["backup"]},"BackupDetail":{"type":"object","properties":{"backup":{"$ref":"#/components/schemas/Backup"},"manifest":{"$ref":"#/components/schemas/BackupManifest"}},"required":["backup"]},"BackupPage":{"type":"object","properties":{"backups":{"type":"array","items":{"$ref":"#/components/schemas/Backup"}},"nextCursor":{"type":"string","nullable":true},"latestConfirmedSnapshotAt":{"type":"string","format":"date-time","nullable":true}},"required":["backups","nextCursor","latestConfirmedSnapshotAt"]},"BackupFiles":{"type":"object","properties":{"path":{"type":"string"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/BackupEntry"}},"nextCursor":{"type":"string","nullable":true},"snapshotAt":{"type":"string","format":"date-time","nullable":true}},"required":["path","entries","nextCursor","snapshotAt"]},"BoxRuntimeObservation":{"type":"object","properties":{"state":{"type":"string","enum":["creating","stopped","active","running","paused","unknown","retiring","retired"]},"observedAt":{"type":"integer","minimum":0,"nullable":true},"leaseId":{"type":"string","nullable":true},"timeoutMs":{"type":"integer","minimum":1000,"nullable":true},"network":{"type":"string","enum":["disabled","enabled"],"nullable":true},"imported":{"type":"boolean"}},"required":["state","observedAt","leaseId","timeoutMs","network","imported"]},"BoxCollectionItem":{"type":"object","properties":{"id":{"type":"string"},"instanceId":{"type":"string"},"name":{"type":"string"},"runtimeKind":{"type":"string","enum":["lite","sandbox"]},"runtimeProfile":{"type":"string"},"businessProjectId":{"type":"string","nullable":true},"state":{"type":"string","enum":["active","paused","retiring","retired"]},"createdAt":{"type":"string","format":"date-time"},"runtime":{"anyOf":[{"$ref":"#/components/schemas/BoxRuntimeObservation"},{"type":"object","nullable":true,"enum":[null]}]}},"required":["id","instanceId","name","runtimeKind","runtimeProfile","businessProjectId","state","createdAt","runtime"]},"BoxCollection":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"$ref":"#/components/schemas/BoxCollectionItem"}},"nextCursor":{"type":"string","nullable":true}},"required":["object","data","nextCursor"]},"Restore":{"type":"object","properties":{"id":{"type":"string"},"backupId":{"type":"string"},"sourceBoxId":{"type":"string"},"targetBoxId":{"type":"string"},"status":{"type":"string","enum":["queued","funding","importing","complete","failed","unknown"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"transferredBytes":{"type":"integer","minimum":0},"totalBytes":{"type":"integer","minimum":0},"errorCode":{"type":"string","nullable":true},"associationStatus":{"type":"string","enum":["none","pending","switched","conflict"]}},"required":["id","backupId","sourceBoxId","targetBoxId","status","createdAt","updatedAt","completedAt","transferredBytes","totalBytes","errorCode","associationStatus"]},"RestoredBox":{"type":"object","properties":{"id":{"type":"string"},"instanceId":{"type":"string"},"organizationId":{"type":"string"},"businessProjectId":{"type":"string","nullable":true},"name":{"type":"string"},"runtimeKind":{"type":"string","enum":["lite","sandbox"]},"runtimeProfile":{"type":"string"},"state":{"type":"string","enum":["active","paused","retiring","retired"]},"version":{"type":"integer","minimum":0},"createdAt":{"type":"string","format":"date-time"}},"required":["id","instanceId","organizationId","businessProjectId","name","runtimeKind","runtimeProfile","state","version","createdAt"]},"RestoreResponse":{"type":"object","properties":{"restore":{"$ref":"#/components/schemas/Restore"},"box":{"$ref":"#/components/schemas/RestoredBox"}},"required":["restore","box"]}},"securitySchemes":{"OrganizationApiKey":{"type":"http","scheme":"bearer","bearerFormat":"sc_…","description":"Organization API key with the required product scopes. Create and manage keys in the Sine Cloud Console. The key fixes the organization and may restrict the project."}}},"security":[{"OrganizationApiKey":[]}]}