Skip to main content
Set or extend the auto-shutdown timeout for a sandbox. When the timeout expires, the sandbox will be automatically deleted.

Endpoint

Request

Headers

Path Parameters

Body Parameters

Example Request

Set timeout to 1 hour (3600 seconds):
Extend timeout by 2 hours:

Response

Success (200 OK)

Response Fields

Status Codes

Errors

Invalid Timeout (400)

Cause: The timeout_seconds value is negative, zero, or invalid. Fix: Ensure timeout_seconds is a positive integer.

Sandbox Not Found (404)

Cause: The sandbox ID doesn’t exist or belongs to another organization. Fix: Verify the sandbox ID is correct.

Important Notes

  • Absolute timeout - The timeout is set from the current time, not relative to the previous timeout
  • Auto-deletion - When the timeout expires, the sandbox is automatically deleted
  • Can be extended - You can extend the timeout multiple times
  • No maximum - There’s no maximum timeout limit (subject to your plan)

Use Cases

Extend Timeout for Long-Running Task

Set Timeout on Creation

Keep Sandbox Alive Indefinitely

Next Steps