Computer Actions
Wait
Pause execution for up to 60 seconds - useful between actions.
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
}'import requests
url = "https://www.orgo.ai/api/computers/{id}/wait"
payload = { "seconds": 2 }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({seconds: 2})
};
fetch('https://www.orgo.ai/api/computers/{id}/wait', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.orgo.ai/api/computers/{id}/wait",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'seconds' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.orgo.ai/api/computers/{id}/wait"
payload := strings.NewReader("{\n \"seconds\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/computers/{id}/wait")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"seconds\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.orgo.ai/api/computers/{id}/wait")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"seconds\": 2\n}"
response = http.request(request)
puts response.read_body{
"success": true
}{
"error": "Invalid API key"
}{
"error": "Resource not found"
}Pauses execution on the computer for the specified duration. The request blocks until the wait completes.
Path parameters
string
required
Computer ID (UUID).
Body parameters
number
required
How long to pause, in seconds (0-60).
number
deprecated
Deprecated alias for
seconds. Accepted on input for backwards compatibility.Response
boolean
true when the wait completes.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}'
import requests
# Wait 2 seconds
requests.post(
f"https://www.orgo.ai/api/computers/{computer_id}/wait",
headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
json={"seconds": 2.0}
)
// Wait 2 seconds
await fetch(`https://www.orgo.ai/api/computers/${computerId}/wait`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ 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
| Status | Meaning |
|---|---|
400 | Invalid or out-of-range seconds value, or computer instance not available. |
401 | Missing or invalid API key. |
403 | You do not have access to this computer. |
404 | Computer not found. |
500 | Upstream desktop agent failure. |
Authorizations
API key authentication. Get your key at orgo.ai/workspaces
Path Parameters
Computer ID
Body
application/json
Response
Wait completed
Example:
true
⌘I
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
}'import requests
url = "https://www.orgo.ai/api/computers/{id}/wait"
payload = { "seconds": 2 }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({seconds: 2})
};
fetch('https://www.orgo.ai/api/computers/{id}/wait', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.orgo.ai/api/computers/{id}/wait",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'seconds' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.orgo.ai/api/computers/{id}/wait"
payload := strings.NewReader("{\n \"seconds\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/computers/{id}/wait")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"seconds\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.orgo.ai/api/computers/{id}/wait")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"seconds\": 2\n}"
response = http.request(request)
puts response.read_body{
"success": true
}{
"error": "Invalid API key"
}{
"error": "Resource not found"
}