Agent Runs
Create an agent run
Starts a new run of the Hermes Managed Agent.
A run is asynchronous: the response returns immediately with status
queued. Poll Get an agent run until the
run reaches a terminal state (succeeded, failed or canceled).
Authorization
bearerAuth AuthorizationBearer <token>
Pass your API key in the Authorization header: Authorization: Bearer sirius_sk_....
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agent/runs" \ -H "Content-Type: application/json" \ -d '{ "input": "Summarize the last 7 days of sign-ups and flag anomalies.", "agent": "hermes", "metadata": { "requested_by": "growth-dashboard" } }'{ "id": "run_01j9x6q8ftq", "status": "queued", "input": "string", "output": "string", "error": "string", "pending_approvals": [ { "id": "apr_01j9x7v2m3", "action": "Send email to 1,204 recipients", "status": "pending", "requested_at": "2019-08-24T14:15:22Z", "resolved_at": "2019-08-24T14:15:22Z" } ], "metadata": { "property1": "string", "property2": "string" }, "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z"}{ "error": { "code": "invalid_request", "message": "string" }}{ "error": { "code": "invalid_request", "message": "string" }}{ "error": { "code": "invalid_request", "message": "string" }}