Agent Computers API

An Agent Computer is a persistent workspace with a long-lived VM. Unlike task-scoped workspaces (which are provisioned per task), an Agent Computer persists across multiple tasks -- all tasks share the same VM, filesystem, and installed packages.

Create Agent Computer

POST /v1/agent-computers

Creates a new Agent Computer. By default, VM provisioning runs in the background and the response returns immediately; poll GET /v1/agent-computers/:id until sandboxId is non-null. There is no separate status or provisionError field.

When db9_enabled is true, creation instead waits for VM provisioning, mounts the DB9 workspace, and mints a DB9 API key. This synchronous path typically takes 10--30 seconds.

Request body:

Field	Type	Required	Description
name	string	No	Display name (default: "Agent Computer", max 200 chars)
icon	string	No	Icon identifier (max 50 chars)
agent_instructions	string or null	No	Workspace-specific Agent instructions (max 100,000 chars); null leaves them empty
agent_profile_id	string	No	UUID of an organization Agent Profile to copy; omit to use the organization default
db9_enabled	boolean	No	Provision DB9 synchronously and return a one-shot API key (default: false)

curl -X POST https://api.rebyte.ai/v1/agent-computers \
  -H "API_KEY: rbk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Agent",
    "agent_instructions": "Focus on backend implementation and tests."
  }'

Response (201):

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Agent",
  "sandboxId": null,
  "icon": null,
  "url": "https://app.rebyte.ai/agent/computer/550e8400-e29b-41d4-a716-446655440000",
  "db9Enabled": false,
  "sandboxBaseUrl": "https://sandbox.example.com",
  "sandboxApiKey": "msb_xxx",
  "createdAt": "2026-01-28T12:00:00.000Z",
  "updatedAt": "2026-01-28T12:00:00.000Z",
  "agentInstructions": "Focus on backend implementation and tests.",
  "views": [
    {
      "id": "view_123",
      "name": "Web search",
      "enabled": true,
      "server": {
        "type": "internal",
        "internalName": "web_search_&_browse",
        "remoteId": null
      }
    }
  ]
}

The views array contains the Agent's tool views. Save each view id if you plan to enable or disable it through PATCH /v1/agent-computers/:id.

---

List Agent Computers

GET /v1/agent-computers?limit=50&offset=0

Returns non-deleted workspaces for your organization, sorted by creation time (newest first). The current route does not filter the result by workspace kind. List items intentionally omit sandbox credentials, instructions, and views.

Param	Type	Default	Description
limit	number	50	Results per page (1--100)
offset	number	0	Pagination offset

curl "https://api.rebyte.ai/v1/agent-computers" \
  -H "API_KEY: rbk_xxx"

Response:

{
  "data": [
    {
      "id": "550e8400-...",
      "name": "My Agent",
      "sandboxId": "abc123",
      "icon": null,
      "url": "https://app.rebyte.ai/agent/computer/550e8400-...",
      "db9Enabled": false,
      "createdAt": "2026-01-28T12:00:00.000Z",
      "updatedAt": "2026-01-28T12:01:00.000Z"
    }
  ],
  "total": 3,
  "limit": 50,
  "offset": 0
}

---

Get Agent Computer

GET /v1/agent-computers/:id

Returns full details, including sandbox connection settings, Agent configuration, task count, and up to 10 recent tasks.

curl https://api.rebyte.ai/v1/agent-computers/550e8400-... \
  -H "API_KEY: rbk_xxx"

Response:

{
  "id": "550e8400-...",
  "name": "My Agent",
  "sandboxId": "abc123",
  "icon": null,
  "url": "https://app.rebyte.ai/agent/computer/550e8400-...",
  "db9Enabled": false,
  "sandboxBaseUrl": "https://sandbox.example.com",
  "sandboxApiKey": "msb_xxx",
  "createdAt": "2026-01-28T12:00:00.000Z",
  "updatedAt": "2026-01-28T12:01:00.000Z",
  "agentInstructions": "Focus on backend implementation and tests.",
  "views": [
    {
      "id": "view_123",
      "name": "Web search",
      "enabled": true,
      "server": {
        "type": "internal",
        "internalName": "web_search_&_browse",
        "remoteId": null
      }
    }
  ],
  "taskCount": 15,
  "recentTasks": [
    {
      "id": "660e8400-...",
      "title": "Build REST API",
      "status": "completed",
      "createdAt": "2026-01-28T12:05:00.000Z",
      "completedAt": "2026-01-28T12:10:00.000Z"
    }
  ]
}

Sandbox Credentials

The create and detail responses include sandboxBaseUrl and sandboxApiKey; list responses do not. Use them with sandboxId to connect through the compatible Microsandbox SDK. The API key is an organization-level gateway credential, so treat it as a secret and do not expose it to browsers, logs, or untrusted clients.

For asynchronous creation, the gateway settings are available immediately while sandboxId remains null. Poll the detail endpoint until sandboxId is non-null before connecting directly to the VM.

---

Configure Agent Computer

PATCH /v1/agent-computers/:id

Updates workspace-specific Agent instructions and/or enables or disables tool views. The instructions are appended after the manager's base prompt; send null to clear them. The views object maps view IDs from the create or detail response to boolean enabled states.

curl -X PATCH https://api.rebyte.ai/v1/agent-computers/550e8400-... \
  -H "API_KEY: rbk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_instructions": "Prioritize concise, production-ready changes.",
    "views": {
      "view_123": false
    }
  }'

Response:

{
  "id": "550e8400-...",
  "agentInstructions": "Prioritize concise, production-ready changes.",
  "views": [
    {
      "id": "view_123",
      "name": "Web search",
      "enabled": false,
      "server": {
        "type": "internal",
        "internalName": "web_search_&_browse",
        "remoteId": null
      }
    }
  ]
}

An unknown view ID returns 400 unknown_view without applying a partial update. An empty request body returns the current Agent configuration.

---

DB9 Credentials

DB9 endpoints are available only for Agent Computers created with db9_enabled: true after their VM is ready.

Create with DB9

curl -X POST https://api.rebyte.ai/v1/agent-computers \
  -H "API_KEY: rbk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "DB9 Agent", "db9_enabled": true}'

The synchronous create response has a non-null sandboxId, db9Enabled: true, and this additional one-shot credential:

{
  "db9ApiKey": {
    "id": "key_123",
    "name": "rebyte-api-550e8400",
    "token": "db9_xxx",
    "createdAt": "2026-01-28T12:00:00.000Z",
    "expiresAt": "2027-01-28T12:00:00.000Z"
  }
}

The Relay does not store the token. Save it in your secret store or mint another key later.

Mint a DB9 API Key

POST /v1/agent-computers/:id/db9/api-key

Mints a new full-account DB9 key with the same rights as the VM's DB9 account. It can create, delete, share, and modify any database owned by that account. The token is returned once and is not stored by the Relay; the default expiry is 365 days.

curl -X POST https://api.rebyte.ai/v1/agent-computers/550e8400-.../db9/api-key \
  -H "API_KEY: rbk_xxx"

Response:

{
  "id": "key_456",
  "name": "rebyte-api-550e8400",
  "token": "db9_xxx",
  "createdAt": "2026-01-28T12:10:00.000Z",
  "expiresAt": "2027-01-28T12:10:00.000Z"
}

Mint a DB9 Share Token

POST /v1/agent-computers/:id/db9/share-token

Mints a read-write token scoped to this Agent Computer's workspace database. DB9 share tokens expire after 7 days by default.

curl -X POST https://api.rebyte.ai/v1/agent-computers/550e8400-.../db9/share-token \
  -H "API_KEY: rbk_xxx"

Response:

{
  "token": "db9_share_xxx",
  "expiresAt": "2026-02-04T12:00:00.000Z"
}

Both mint endpoints return 400 db9_not_enabled when DB9 is disabled and 404 not_ready while the Agent Computer has no VM.

---

Running Tasks on an Agent Computer

To run a task on an existing Agent Computer, pass its id as the workspaceId when creating a task:

curl -X POST https://api.rebyte.ai/v1/tasks \
  -H "API_KEY: rbk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Build a REST API with Express",
    "workspaceId": "550e8400-e29b-41d4-a716-446655440000"
  }'

This reuses the persistent VM and is significantly faster than creating a new workspace. See the Tasks API for full task endpoint documentation.