Skip to main content
Extend or reduce the timeout for a running sandbox.

Basic Request

curl -X POST https://api.gravixlayer.com/v1/agents/sandboxes/550e8400-e29b-41d4-a716-446655440000/timeout \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeout": 1800
  }'

Request Parameters

ParameterTypeRequiredDescription
timeoutintegerYesNew timeout in seconds (60-3600)

Response

{
  "message": "Timeout updated successfully",
  "timeout": 1800,
  "timeout_at": "2025-10-23T13:00:00Z"
}

Response Fields

FieldTypeDescription
messagestringSuccess message
timeoutintegerNew timeout in seconds
timeout_atstringWhen the sandbox will timeout (ISO 8601)

Common Timeout Values

Use CaseRecommended Timeout
Quick scripts300s (5 minutes)
Data processing1800s (30 minutes)
ML training3600s (1 hour)

Next Steps