Skip to main content
POST
/
computers
/
{id}
/
wait
Wait
curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/wait \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "seconds": 2
}'
{
  "success": true
}
Pauses execution on the computer for the specified duration. The request blocks until the wait completes.

​
Path parameters

​
id
string
required
Computer ID (UUID).

​
Body parameters

​
seconds
number
required
How long to pause, in seconds (0-60).
​
duration
number
deprecated
Deprecated alias for seconds. Accepted on input for backwards compatibility.

​
Response

​
success
boolean
true when the wait completes.
​
action
string
Always wait.

​
Example

curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/wait \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seconds": 2.0}'

​
Response

{
  "success": true,
  "action": "wait"
}
Use waits sparingly - prefer polling for the condition you actually care about (window focus, file change) over fixed delays.

​
Errors

StatusMeaning
400Invalid or out-of-range seconds value, or computer instance not available.
401Missing or invalid API key.
403You do not have access to this computer.
404Computer not found.
500Upstream desktop agent failure.

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
​
seconds
number
required

How long to pause, in seconds

Required range: 0 <= x <= 60
​
duration
number
deprecated

Deprecated alias for seconds. Accepted on input for backwards compatibility.

Required range: 0 <= x <= 60

Response

Wait completed

​
success
boolean
Example:

true