POST /config

`POST /config`

Create or update the configuration for an agent. This sets the daily budget limit and optional Slack webhook. The SDK calls this automatically on startup when you pass cost_threshold to AgentFlare(...).

Request

POST /config
x-api-key: ag_your_key_here
Content-Type: application/json

{
  "agent_id": "my-sales-agent",
  "cost_threshold_usd": 10.0,
  "slack_webhook_url": "https://hooks.slack.com/services/T.../B.../..."
}

Fields

Field	Type	Required	Default	Description
`agent_id`	`string`	Yes	—	The agent to configure.
`cost_threshold_usd`	`float`	No	`10.0`	Daily spend limit in USD. The agent is auto-paused when this is exceeded.
`slack_webhook_url`	`string`	No	`null`	Slack incoming webhook URL. A message is sent when the agent is auto-paused.

Response

{ "ok": true }

`POST /config/pause`

Manually pause or resume an agent. This overrides the threshold — you can pause an agent that hasn't hit its budget, or resume one that has.

POST /config/pause
x-api-key: ag_your_key_here
Content-Type: application/json

{
  "agent_id": "my-sales-agent",
  "is_paused": true
}

Fields

Field	Type	Required	Description
`agent_id`	`string`	Yes	The agent to pause or resume.
`is_paused`	`boolean`	Yes	`true` to pause, `false` to resume.

Response

{
  "ok": true,
  "agent_id": "my-sales-agent",
  "is_paused": true
}

How config is stored

Config is stored in the agent_configs table in Supabase. The upsert is keyed on (agent_id, user_id), so calling POST /config twice for the same agent is safe — it updates, not duplicates.

Curl examples

Set threshold:

curl -X POST <your-backend-url>/config \
  -H "x-api-key: ag_your_key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my-agent", "cost_threshold_usd": 5.0}'

Resume a paused agent:

curl -X POST <your-backend-url>/config/pause \
  -H "x-api-key: ag_your_key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my-agent", "is_paused": false}'

On this page