Skip to main content
These commands use the Durable Agent Sessions API and the API key configured by oc login, OPENCOMPUTER_API_KEY, or --api-key.

​
oc agent invoke

Start a durable session through an agent’s canonical URL:
--data defaults to {}. The CLI rejects non-JSON input locally, calls exact POST / with the configured org key, and prints the accepted session id plus follow/steer commands. It generates one idempotency key and keeps it stable across automatic retries; supply your own key when separate command runs must converge. With --json, the output is the complete acceptance receipt, including the one-hour session client token and canonical event/message links. Treat that output as a session-scoped credential. Use oc session create instead when you need model, source, destination, or per-session limit overrides.

​
oc agent hook create

Creates a named Hook and prints its complete secret URL once. If --agent is omitted, the CLI resolves the agent from agent.toml in the current directory.

​
oc agent hooks

Lists secret-free Hook metadata. Pagination is newest-first and the server caps --limit at 100.

​
oc agent hook get

Shows status, expiry, secret last four, and revoke reason. It cannot recover the complete URL.

​
oc agent hook revoke

Irreversibly revokes the Hook after confirmation. Create and install a replacement first if the external integration must stay available.