Skip to main content
PATCH
/
computers
/
{id}
/
auto-stop
Update auto-stop setting
curl --request PATCH \
  --url https://www.orgo.ai/api/computers/{id}/auto-stop \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "auto_stop_minutes": 0
}
'
{
  "auto_stop_minutes": 0,
  "auto_suspend_after": "0s"
}

Documentation Index

Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 configurable only on paid plans. Free-tier computers are fixed at 15 minutes.

​
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}'

​
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 — Auto-stop is not configurable on the free plan, or no access to this computer
  • 404 — Computer not found

Authorizations

​
Authorization
string
header
required

API key authentication. Get your key at orgo.ai/workspaces

Path Parameters

​
id
string
required

Computer ID

Body

application/json
​
auto_stop_minutes
integer
required

Minutes of inactivity before auto-stop. Set to 0 to disable.

Required range: x >= 0
Example:

0

Response

Auto-stop updated

​
auto_stop_minutes
integer
Example:

0

​
auto_suspend_after
string
Example:

"0s"