Run a product [write]

Changed on

String 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.

post/runs

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/runs
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

Scoped to the authenticated person, universe, operation, and target. Changed input returns 409; token renewal preserves identity.

Request body

productstring required
inputunknown required
addonsobject
session_idstring
streamboolean
metadataobject

Response

Durable Run identity, status, output and references to authoritative billing.

Changes