Skip to main content
POST
Create Agent
Create a new agent. For managed agents, pass core to get a pre-configured runtime. For raw agents, pass config with your own snapshot and entrypoint. CLI equivalent: oc agent create <id> [--core <core>] [--secret KEY=VALUE]
string
required
Agent ID. Must be DNS-safe (lowercase alphanumeric + hyphens).
string
Human-readable display name
string
Managed core (hermes or openclaw). Mutually exclusive with config.
object
Raw agent configuration. Mutually exclusive with core.
string
Snapshot to boot the sandbox from
string
Command to run on sandbox start
object
Alternative to entrypoint — uses sandbox.agent.start() with system_prompt and allowed_tools
object
Environment variables
object
Memory elasticity. baseline_mb and max_mb.
integer
Idle timeout in seconds
object
Key-value map of secrets to set on creation