Overview

The Sirius API is a REST API for the Hermes Managed Agent: create agent runs, poll their state and resolve approvals when a run needs a human decision. Every reference page in this section is generated from the OpenAPI spec — it is never written by hand, so it cannot drift from the contract.

Base URL

https://api.thesirius.ai

All endpoints are versioned under /v1. Breaking changes ship as a new version prefix; /v1 stays stable.

Authentication

Authenticate with an API key in the Authorization header:

curl https://api.thesirius.ai/v1/agent/runs \
  -H "Authorization: Bearer $SIRIUS_API_KEY"

See the authentication guide for how keys are issued and rotated.

Conventions

• Request and response bodies are JSON (application/json).
• Identifiers are prefixed strings: run_... for runs, apr_... for approvals.
• List endpoints paginate with cursor / next_cursor.
• Errors return a consistent envelope:

{
  "error": {
    "code": "invalid_request",
    "message": "input is required"
  }
}

Start here