Agent on Demand API Skill

Reference for driving the Agent on Demand REST API — three resources (agents, environments, sessions) used to run AI coding agents inside Sprites.

When This Skill Applies

Use this skill when:

• Calling the Agent on Demand API from code, tests, or curl (creating agents, environments, or sessions)
• Writing or maintaining e2e tests in tests/e2e/
• Adding new endpoints — keep the conventions here consistent
• Debugging 4xx responses (especially 409, 422, 429, or the detail-is-a-list edge case)

Canonical spec: docs/openapi.yaml. The operator site is rendered at https://ravi-hq.github.io/agent-on-demand. This skill is the shorter operator view with the gotchas front-loaded.

Base URL & Auth

• Dev: http://localhost:8777 (what make dev serves)
• E2E default when invoking through make: same http://localhost:8777; raw pytest defaults to http://localhost:8000
• Every endpoint except GET /health requires Authorization: Bearer aod_<token>. Tokens are created server-side via APIKey.create_key(user, name) (Django shell/management command).