Skip to main content
The Agents API is a higher-level interface for running AI agents on OpenComputer. Instead of managing sandboxes directly, you define an Agent (configuration) and then create Instances (persistent) or Sessions (ephemeral) from it.
ConceptWhat it isLifecycleUse case
AgentConfiguration — snapshot, entrypoint, secrets, elasticityIndefiniteDefine once, reuse
InstancePersistent sandbox, hibernates/wakes, multiplexes conversationsLong-livedAI coworkers (Slack, Teams)
SessionEphemeral sandbox, runs to completionBoundedBatch jobs, webhook handlers

​
Base URL

https://api.opencomputer.dev

​
Authentication

All requests require an OpenComputer API key via X-API-Key. The key is passed through to the OC SDK for sandbox operations. 
X-API-Key: osb_your_api_key

​
Errors

{
  "error": {
    "type": "invalid_request | not_found | conflict | internal_error",
    "message": "Human-readable description"
  }
}