Back to How-To
Update Agent Configuration
Change your agent's settings without creating a new one.
What You Can Update
Name, description, endpoint URL, auth, prompts, regions, schedule, timeout, TTFB SLA, max nodes, alerts.
From Dashboard
Open agent → Settings → Modify → Save Changes. Takes effect next run.
From API
curl -X PATCH "https://api.agentstatus.dev/api/v1/agents/{agent_id}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"interval_minutes": 30, "alert_email": "new@example.com"}'
Only include fields you want to change.
Common Updates
Rotate Auth Token
curl -X PATCH "..." -d '{"auth": {"type": "bearer", "token": "new-key"}}'
# Then trigger manual run to verify
Change Regions
curl -X PATCH "..." -d '{"geos": ["us", "eu", "ap", "latam"]}'
Update Prompts
curl -X PATCH "..." -d '{"prompts": ["What services do you offer?", "How can I contact support?"]}'
Tier Restrictions
Settings beyond your tier return 402 with upgrade prompt.
History Preserved
Updating config does NOT delete history, change agent ID, or invalidate results.