Skip to main content
PATCH
Set Timeout
Updates the timeout stored on the sandbox and restarts its countdown from now. When the countdown ends the sandbox is killed, or paused if it was created with lifecycle.on_timeout: "pause". On an on-prem deployment, pass 0 to disable the timeout; Declaw Cloud rejects 0 with 400. For a paused sandbox the new value takes effect when it is resumed; a paused sandbox is kept until it is resumed or killed. Use this endpoint to extend a sandbox’s lifetime before it expires, or to reduce the timeout if you want to reclaim resources sooner.

Path Parameters

string
required
The sandbox identifier. Format: sbx-<8 chars>.

Request Body

integer
required
New timeout value in seconds. 0 disables the timeout and is accepted only by on-prem deployments; Declaw Cloud rejects it with 400, and a value above your plan’s maximum session with 403 tier_limit.Example: 600

Response

boolean
Always true when the update succeeds.

Example

Response

Error Responses