Skip to main content
POST
/
v1
/
agents
/
{agentId}
/
instances
Create Instance
curl --request POST \
  --url https://app.opencomputer.dev/v1/agents/{agentId}/instances \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "metadata": {}
}'
{
  "id": "inst_98adcc7e",
  "agent_id": "my-hermes",
  "status": "creating",
  "metadata": { "slack_user": "U123" },
  "created_at": "2026-04-09T10:30:00Z",
  "updated_at": "2026-04-09T10:30:00Z"
}
Create a persistent instance for an agent. The platform provisions a sandbox from the agent’s snapshot in the background.
​
agentId
string
required
Agent ID
​
metadata
object
Arbitrary metadata for matching instances to external identities (e.g. Slack user IDs)
{
  "id": "inst_98adcc7e",
  "agent_id": "my-hermes",
  "status": "creating",
  "metadata": { "slack_user": "U123" },
  "created_at": "2026-04-09T10:30:00Z",
  "updated_at": "2026-04-09T10:30:00Z"
}