Run a product [write]
Changed onString input is a shortcut. Agent objects preserve one user message and optional system message. Direct Agent Runs prepare a Session with platform billing; an existing Session retains its payer and billing settings. Non-streaming waits up to ten seconds. SSE begins with the durable Run identity. Disconnect never cancels execution. A catalog handle (@handle) runs that agent as one turn of a new session of it, charged as that session is: addons may set model, within the agent's engine, and instructions, files added after the agent's own, and nothing else; a user.message sent to the Run (POST /runs/{id}/events) is the next turn of that session and a Run of its own. When a Run of a handle ends, each webhook endpoint of the workspace subscribed to run.completed, run.interrupted, run.failed or run.blocked receives that event once, signed like every other webhook. A handle whose agent has not passed its checks is refused with listing_not_checked or listing_checks_failed.
Request
- Base URLhttps://api.agentsky.dev/v1
- URLhttps://api.agentsky.dev/v1/runs
- AuthHTTP bearer
Headers
Scoped to the authenticated person, universe, operation, and target. Changed input returns 409; token renewal preserves identity.
Request body
Response
Durable Run identity, status, output and references to authoritative billing.
Changes
- info
endpoint added
- info