Skip to main content

Overview

The Orgo API lets you create projects, provision virtual computers, and control them programmatically. Build AI agent fleets, automation workflows, or browser testing at scale.

Authentication

All requests require a Bearer token:
Authorization: Bearer your_api_key
Get your API key at orgo.ai/projects.

Base URL

https://www.orgo.ai/api

Quick Start

1. Create a Project

Projects are containers for computers.
curl -X POST https://www.orgo.ai/api/projects \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "manus"}'

2. Create a Computer

Add a computer to your project:
curl -X POST https://www.orgo.ai/api/projects/manus/computers \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "agent-1",
    "os": "linux",
    "ram": 2,
    "cpu": 2
  }'

3. Control the Computer

# Screenshot
curl https://www.orgo.ai/api/projects/manus/computers/agent-1/screenshot \
  -H "Authorization: Bearer your_api_key"

# Click
curl -X POST https://www.orgo.ai/api/projects/manus/computers/agent-1/click \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"x": 100, "y": 200}'

# Type
curl -X POST https://www.orgo.ai/api/projects/manus/computers/agent-1/type \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world"}'

Resource Hierarchy

User
└── Projects (e.g., "manus")
    └── Computers (e.g., "agent-1", "agent-2")
Projects organize your computers. Free tier: 2 concurrent computers.

Computer Specs

  • OS: Linux or Windows
  • RAM: 2GB, 4GB, or 8GB
  • CPU: 2, 4, or 8 cores
  • GPU: None, T4, or A10 (coming soon)

Control Operations

Mouse

  • Click (left, right, double)
  • Drag
  • Scroll

Keyboard

  • Type text
  • Press keys (Enter, Tab, ctrl+c, etc.)

Execution

  • Bash commands
  • Python code

Other

  • Screenshots
  • Wait/delays
  • Streaming (RTMP)

Error Responses

{
  "error": "Error message"
}
Status codes:
  • 200 - Success
  • 400 - Invalid request
  • 401 - Invalid API key
  • 404 - Resource not found
  • 500 - Server error

Next Steps

I