Skip to content
Sine Cloud
BoxOpenAPI

Start, extend or stop a Sandbox window

POST/api/box/v1/{boxId}/runtime

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.

Organization API key authentication

Authorization: Bearer $SINECLOUD_API_KEY

Required scopes: boxRun

Parameters

boxId · path · Required
Existing Box resource ID selected in Console, not its parent product activation ID.

Request body

Required

application/json

Responses

200
Observed lease, original billing and optional extension state/quote.
400
Invalid fields, identity, path, cursor or query. Unknown/duplicate fields are rejected where validated.
401
Missing, invalid, expired or revoked organization credential.
402
Insufficient available organization credits for the reservation.
403
Current issuer membership, product scope, project, resource lifecycle or entitlement denies access.
404
Resource, execution, snapshot, restore or file not found within the authorized organization.
409
State/identity conflict or unresolved execution. Observe the original durable identity; do not create replacement work to bypass uncertainty.
413
JSON body exceeds its byte limit.
415
Use Content-Type: application/json.
429
Admission concurrency, rate or budget limit reached.
500
The request could not be completed. Preserve any durable identity before retrying.
503
Runtime, deployment or recovery evidence is unavailable. Read existing status before retrying an uncertain mutation.

Loading API reference…

Box · Setup & authentication

Base URLhttps://sinecloud.dev/api/box/v1/{boxId}

Open Console · Create an API key · Browse all APIs

Download API index

Before your first request

Select your organization, prepare resources in Console, and issue an organization API key with the required product scopes. Current permissions, resource access, budget and available funds are checked on every call.

Create and select a Box in Console. Replace boxId with the actual Box resource ID, never the parent activation ID. The catalog covers workspace files, directories, command execution, durable status, Sandbox runtime windows and retained backups. Lite commands need no VM start step. Sandbox commands require an explicitly confirmed and funded runtime window; idle allocated VM time is also billed. File access never starts a VM.

Grant the scopes documented on each operation, such as boxRun, fileRead or fileWrite. Creating a backup requires both boxRun and fileRead. Resource creation, restore initiation and backup deletion use Console sessions. Retain the original execution identity when recovering uncertain work.

Organization key authentication and base URL

The production API origin is https://sinecloud.dev; the documentation origin does not serve product requests. The path prefix is /api/box/v1/{boxId}. Use the complete path documented for the operation, replacing resource IDs, models and endpoint revisions with your actual selections.

Authorization: Bearer $SINECLOUD_API_KEY

Set SINECLOUD_API_KEY to your own environment variable value; never use platform service credentials. Each operation lists required scopes in x-sinecloud-scopes.

This reference is read-only. Run requests in Console or your own client. Browsing documentation never creates a key, starts execution or incurs an execution charge. Keep request IDs and execution receipts; a lost connection does not cancel work. Follow the operation’s recovery instructions before submitting again.

Sine CloudDocs
Console

Type to search…

↑↓ navigate↵ selectEsc Close