# Sirius Docs

## Guides

- [Authentication](https://docs.thesirius.ai/guides/authentication): How Sirius API keys work — scopes, storage and rotation.
- [Getting started](https://docs.thesirius.ai/guides/getting-started): Authenticate and run your first agent task in five minutes.
- [Guides](https://docs.thesirius.ai/guides): Hands-on guides for building with the Sirius platform.

## API Reference

- [Overview](https://docs.thesirius.ai/api): The Sirius API — base URL, authentication and conventions.
- [Service health](https://docs.thesirius.ai/api/health/service-health): Returns the current status of the API and its upstream dependencies. This endpoint does not require authentication.

- [List agent runs](https://docs.thesirius.ai/api/agent-runs/list-agent-runs): Returns your agent runs, most recent first.
- [Create an agent run](https://docs.thesirius.ai/api/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](#operation/getAgentRun) until the
run reaches a terminal state (`succeeded`, `failed` or `canceled`).

- [Get an agent run](https://docs.thesirius.ai/api/agent-runs/get-an-agent-run): Returns the current state of a run, including its output once the run has finished and any approval currently blocking it.

- [Resolve an approval](https://docs.thesirius.ai/api/approvals/resolve-an-approval): Approves or denies a pending approval request. Runs that perform
sensitive actions pause with status `awaiting_approval` until every
pending approval is resolved.


## Changelog

- [docs.thesirius.ai is live](https://docs.thesirius.ai/changelog/docs-platform-launch): The Sirius documentation platform launches with an auto-generated API reference, guides and this changelog.