Skip to main content
POST
/
v1
/
agents
/
{agentId}
/
sessions
Create Session
curl --request POST \
  --url https://app.opencomputer.dev/v1/agents/{agentId}/sessions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "input": {},
  "metadata": {}
}
'
{
  "id": "sess_98adcc7e",
  "agent_id": "issue-resolver",
  "status": "creating",
  "input": { "repo": "acme/backend", "issue_number": 42 },
  "result": null,
  "preview_url": null,
  "metadata": { "trigger": "github_webhook" },
  "created_at": "2026-04-09T10:30:00Z",
  "updated_at": "2026-04-09T10:30:00Z"
}
Create an ephemeral session. The platform creates a sandbox, writes input to /tmp/agent_input.json, sets AGENT_INPUT_PATH, and runs the agent’s entrypoint.
agentId
string
required
Agent ID
input
object
Input data written to /tmp/agent_input.json in the sandbox
metadata
object
Arbitrary metadata
{
  "id": "sess_98adcc7e",
  "agent_id": "issue-resolver",
  "status": "creating",
  "input": { "repo": "acme/backend", "issue_number": 42 },
  "result": null,
  "preview_url": null,
  "metadata": { "trigger": "github_webhook" },
  "created_at": "2026-04-09T10:30:00Z",
  "updated_at": "2026-04-09T10:30:00Z"
}