One API call to trigger an agent
Everything Percy can do through the dashboard, your code can do through the API. Build custom workflows, trigger agents programmatically, and integrate Percy into your own systems.
curl -X POST https://api.percy.ai/v1/agents/run \
-H "Authorization: Bearer $PERCY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent": "operations",
"task": "Process all pending orders",
"options": {
"auto_label": true,
"notify_customers": true,
"sync_inventory": true
}
}'One call. Your Operations Agent processes every pending order, generates shipping labels, notifies customers, and syncs inventory — then reports back with the results.
{
"status": "completed",
"orders_processed": 12,
"labels_generated": 12,
"customers_notified": 12,
"duration_ms": 4820
}Endpoints
Four APIs, full control
Agents API
Trigger agent runs, check execution status, read results and reasoning chains.
Webhooks
Real-time notifications for agent events, order updates, escalations, and errors.
Data API
Query orders, customers, inventory, and agent logs.
Management API
Configure agents, update guardrails, manage integrations programmatically.
Developer experience
Auth
OAuth 2.0 with scoped tokens
SDKs
Python, Node.js, Go
Spec
OpenAPI 3.0 — auto-generate clients
Rate limits
10,000 req/min with burst
Versioning
Semver — breaking changes in majors only
Status
Private beta — waitlist gets first access