---
canonical_url: "https://docs.composio.dev/toolkits/orgo"
markdown_url: "https://docs.composio.dev/toolkits/orgo.md"
product: "platform"
version: null
last_updated: null
---

# Orgo

Orgo provides cloud computers that agents can create, control, automate, and manage through an API.

- **Category:** ai agents
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `ORGO`
- **Version:** 00000000_00

## Tools

### Control Pointer

**Slug:** `ORGO_CONTROL_POINTER`

Perform one pointer action on a running Orgo computer: click, drag, or scroll. The action is applied immediately and a click may submit forms or trigger irreversible effects. Inspect a fresh screenshot and verify the intended effect before acting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x` | integer | No | Click x-coordinate; required only for click. |
| `y` | integer | No | Click y-coordinate; required only for click. |
| `end_x` | integer | No | Drag end x-coordinate; required only for drag. |
| `end_y` | integer | No | Drag end y-coordinate; required only for drag. |
| `action` | string ("click" | "drag" | "scroll") | Yes | Single pointer action to perform: click, drag, or scroll. |
| `amount` | integer | No | Scroll amount of at least 1; used only for scroll. |
| `button` | string ("left" | "right") | No | Mouse button for click or drag. |
| `double` | boolean | No | Whether click is a double-click; used only for click. |
| `start_x` | integer | No | Drag start x-coordinate; required only for drag. |
| `start_y` | integer | No | Drag start y-coordinate; required only for drag. |
| `duration` | number | No | Drag duration in seconds; used only for drag. |
| `confirmed` | boolean | Yes | Must be true only after the user confirms this exact pointer action and computer ID, because a click may submit forms or trigger irreversible effects. This confirmation is not sent to Orgo. |
| `direction` | string ("up" | "down") | No | Scroll direction; required only for scroll. |
| `computer_id` | string | Yes | Running Orgo computer ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Computer

**Slug:** `ORGO_CREATE_COMPUTER`

Create and automatically start a virtual computer in an accessible workspace. This may consume quota or incur usage charges; call only after the user confirms the target workspace and requested resources.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `os` | string | No | Operating system. Orgo currently supports Linux. |
| `cpu` | integer ("1" | "2" | "4" | "8" | "16") | No | Virtual CPU count, subject to the account plan. |
| `ram` | integer ("4" | "8" | "16" | "32" | "64") | No | Memory in GB, subject to the account plan. |
| `name` | string | Yes | Human-readable name for the new computer. |
| `confirmed` | boolean | Yes | Must be true only after the user confirms creation and the requested resource size. This confirmation is not sent to Orgo. |
| `resolution` | string | No | Display resolution in WIDTHxHEIGHTxDEPTH format. |
| `disk_size_gb` | integer | No | Disk size in GB, subject to the account plan. |
| `template_ref` | string | No | Optional ready template ref in namespace/name@version form. |
| `workspace_id` | string | Yes | ID of the accessible workspace in which to create the computer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Computer

**Slug:** `ORGO_DELETE_COMPUTER`

Permanently delete one Orgo computer and its data. This cannot be undone. Call only when the user explicitly confirms the exact computer ID and permanent deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `confirmed` | boolean | Yes | Must be true only after the user explicitly confirms permanent deletion of this computer ID. This confirmation is not sent to Orgo. |
| `computer_id` | string | Yes | Exact Orgo computer ID to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute Code

**Slug:** `ORGO_EXECUTE_CODE`

Execute arbitrary Bash or Python code on an Orgo computer. Code can read secrets, alter data, access networks, or delete files. Show the exact code and target computer to the user and call only after explicit confirmation. A provider-reported execution failure is returned as result data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | Yes | Exact Bash command or Python source code the user has reviewed. |
| `timeout` | integer | No | Python execution timeout in seconds from 1 to 300; unavailable for Bash. |
| `language` | string ("bash" | "python") | Yes | Execution environment: Bash or Python. |
| `confirmed` | boolean | Yes | Must be true only after the user explicitly confirms this exact code and computer ID. This confirmation is not sent to Orgo. |
| `computer_id` | string | Yes | Exact running Orgo computer ID on which to execute code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Computer

**Slug:** `ORGO_GET_COMPUTER`

Get current details and status for one Orgo computer. Use after creation or a power operation to observe state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `computer_id` | string | Yes | Orgo computer ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Screenshot

**Slug:** `ORGO_GET_SCREENSHOT`

Capture the current display of a running Orgo computer for visual inspection before deciding on mouse or keyboard input.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `computer_id` | string | Yes | Running Orgo computer ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Templates

**Slug:** `ORGO_LIST_TEMPLATES`

List either templates owned by the connected account or Orgo-maintained curated templates. Returns refs that can be supplied when creating a computer.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source` | string ("owned" | "curated") | No | Which template catalog to list: curated Orgo templates or templates owned by the account. |
| `namespace` | string | No | Optional namespace filter for owned templates; unavailable for the curated catalog. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workspaces

**Slug:** `ORGO_LIST_WORKSPACES`

List workspaces accessible to the connected Orgo key, including the computers in each workspace. Use this to discover workspace and computer IDs before other calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Computer Agent

**Slug:** `ORGO_RUN_COMPUTER_AGENT`

Run one non-streaming computer-use agent task on a running Orgo computer. The agent acts immediately and autonomously: it can click or submit forms, type content, execute shell commands, access external services, modify files or accounts, and take destructive or irreversible actions. Use only when the requested task and target computer are authorized. Returns Orgo's complete OpenAI-compatible JSON response without assuming an unverified success shape.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task` | string | Yes | One user instruction for the computer-use agent. The agent may immediately click, type, run shell commands, access external services, modify data, or delete data while completing it. |
| `model` | string ("claude-sonnet-5" | "claude-opus-5" | "claude-opus-4.8" | "claude-sonnet-4.6" | "claude-opus-4.6") | No | Documented Orgo computer-use model identifier. |
| `confirmed` | boolean | Yes | Must be true only after the user confirms this exact task and computer ID, because the agent acts autonomously and can take destructive or irreversible actions. This confirmation is not sent to Orgo. |
| `thread_id` | string | No | Optional thread ID returned by an earlier completion. When provided, Orgo loads that thread's history and appends this task on completion. |
| `computer_id` | string | Yes | ID of the running Orgo computer the agent will control. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Keyboard Input

**Slug:** `ORGO_SEND_KEYBOARD_INPUT`

Send either literal text or one key or key combination to the current keyboard focus on a running Orgo computer. Input is applied immediately and may submit forms or trigger irreversible effects. Inspect a fresh screenshot first, and do not type secrets unless the user explicitly directs it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | No | Key or combination such as Enter or ctrl+c. Mutually exclusive with text. |
| `text` | string | No | Literal text to type at the current keyboard focus. Mutually exclusive with key. |
| `confirmed` | boolean | Yes | Must be true only after the user confirms this exact input and computer ID, because typing may submit forms or trigger irreversible effects. This confirmation is not sent to Orgo. |
| `computer_id` | string | Yes | Running Orgo computer ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Computer Power State

**Slug:** `ORGO_SET_COMPUTER_POWER_STATE`

Start, stop, or restart one Orgo computer after explicit user confirmation. Stop preserves disk but releases the host, start may assign a new host, and restart rotates connection credentials. The response only acknowledges that Orgo accepted the operation; use GET_COMPUTER afterward to observe current state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `confirmed` | boolean | Yes | Must be true after the user confirms the state change; restart also rotates connection credentials. This field is not sent to Orgo. |
| `operation` | string ("start" | "stop" | "restart") | Yes | Power operation to perform: start, stop, or restart. |
| `computer_id` | string | Yes | Orgo computer ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
