Skip to main content
Read or update a computer’s auto-stop setting. When idle for the configured number of minutes, the computer suspends to save resources and resumes on the next API call.
Auto-stop is disabled by default. Set auto_stop_minutes to a positive integer to suspend idle computers, or 0 to keep them always-on.

​
Path parameters

​
id
string
required
Computer ID.

​
GET - Read current setting

GET /computers/{id}/auto-stop

​
Response

​
auto_stop_minutes
integer
Current auto-stop in minutes. 0 means never auto-stop.
​
configurable
boolean
true if your plan allows changing this value.

​
PATCH - Update setting

PATCH /computers/{id}/auto-stop

​
Body parameters

​
auto_stop_minutes
integer
required
Minutes of inactivity before auto-stop. Set to 0 to disable.

​
Response

​
auto_stop_minutes
integer
New value.
​
auto_suspend_after
string
Internal duration string used by the VMM (e.g. 15m, 0s).

​
Example

# Get current setting
curl https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/auto-stop \
  -H "Authorization: Bearer $ORGO_API_KEY"

# Disable auto-stop (always-on)
curl -X PATCH https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/auto-stop \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"auto_stop_minutes": 0}'

import requests

# Disable auto-stop
response = requests.patch(
    f"https://www.orgo.ai/api/computers/{computer_id}/auto-stop",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={"auto_stop_minutes": 0}
)
print(response.json())

const response = await fetch(`https://www.orgo.ai/api/computers/${computerId}/auto-stop`, {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ auto_stop_minutes: 0 })
});

console.log(await response.json());

​
Response

{
  "auto_stop_minutes": 0,
  "auto_suspend_after": "0s"
}

​
Errors

  • 400 - auto_stop_minutes is not a non-negative integer, or provider doesn’t support auto-stop
  • 401 - Invalid or missing API key
  • 403 - No access to this computer
  • 404 - Computer not found