Orgo - Cloud computers for AI agents

POST

computers

{id}

key

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/key \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "Enter"
}'

{
  "success": true
}

{
  "error": "Invalid API key"
}

{
  "error": "Resource not found"
}

Presses a key or key combination. Pass modifiers joined with + (for example ctrl+shift+t).

Path parameters

string

required

Computer ID (UUID).

Query parameters

string

Which screen to act on. Omit for the screen the computer booted with. An unknown id returns 404 rather than falling back — silently acting on the default would put this on somebody else’s desktop.

Body parameters

string

required

Key or key combination to press.

Common keys

Key	Description
`Enter`	Enter/Return key
`Tab`	Tab key
`Escape`	Escape key
`Backspace`	Backspace key
`Delete`	Delete key
`Up`, `Down`, `Left`, `Right`	Arrow keys
`Home`, `End`	Home/End keys
`Page_Up`, `Page_Down`	Page navigation
`F1`-`F12`	Function keys

Common combinations

Combination	Description
`ctrl+c`	Copy
`ctrl+v`	Paste
`ctrl+a`	Select all
`ctrl+s`	Save
`alt+Tab`	Switch windows
`alt+F4`	Close window
`ctrl+shift+t`	Reopen closed tab

Response

boolean

true if the key was pressed.

string

Always key_press.

Example

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

# Ctrl+C
curl -X POST https://www.orgo.ai/api/computers/a3bb189e-8bf9-3888-9912-ace4e6543002/key \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "ctrl+c"}'

import requests

# Press Enter
requests.post(
    f"https://www.orgo.ai/api/computers/{computer_id}/key",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={"key": "Enter"}
)

# Ctrl+C
requests.post(
    f"https://www.orgo.ai/api/computers/{computer_id}/key",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={"key": "ctrl+c"}
)

// Press Enter
await fetch(`https://www.orgo.ai/api/computers/${computerId}/key`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ key: 'Enter' })
});

// Ctrl+C
await fetch(`https://www.orgo.ai/api/computers/${computerId}/key`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ key: 'ctrl+c' })
});

Response

{
  "success": true,
  "action": "key_press",
  "details": { "key": "Enter" }
}

Errors

Status	Meaning
`400`	Missing `key`, 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

Authorization

string

header

required

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

Path Parameters

string

required

Computer ID

Query Parameters

screen

string

Which screen to act on. Omit for the boot screen. An unknown id returns 404 rather than falling back.

Body

application/json

key

string

required

Key or key combination (e.g., Enter, Tab, ctrl+c, alt+F4)

Example:

"Enter"

Response

Key pressed

success

boolean

Example:

true

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/key \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "Enter"
}'

{
  "success": true
}

{
  "error": "Invalid API key"
}

{
  "error": "Resource not found"
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Press key

Path parameters

Query parameters

Body parameters

Common keys

Common combinations

Response

Example

Response

Errors

Authorizations

Path Parameters

Query Parameters

Body

Response

​Path parameters

​Query parameters

​Body parameters

​Common keys

​Common combinations

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Query Parameters

Body

Response

Path parameters

Query parameters

Body parameters

Common keys

Common combinations

Response

Example

Response

Errors