API Overview

Base URL

The SDK points to the AgentFlare backend automatically — you don't need to configure anything.

If you're self-hosting, pass backend_url when initializing:

guard = AgentFlare(api_key="ag_...", agent_id="my-agent", backend_url="https://your-backend.com")

All endpoints require an x-api-key header:

x-api-key: ag_your_key_here

Method	Path	What it does
`POST`	`/events`	Ingest an event from your agent
`POST`	`/config`	Set budget threshold and Slack webhook
`POST`	`/config/pause`	Manually pause or resume an agent
`GET`	`/agents`	List all agents with 24h cost totals
`GET`	`/agents/{id}`	Full detail for one agent
`GET`	`/agents/{id}/hourly`	Hourly cost buckets (last 24h)

The backend exposes a live Swagger UI — check the link in your dashboard settings or append /docs to your backend URL.

Ingest LLM call events.

Set thresholds and Slack webhooks.

List and inspect agents.