Run agents on demand
Trigger any agent in your workspace via a single POST. Pass context, receive structured output, and poll for async results.
POST /v1/workspaces/{id}/agents/{agentId}/runsREST API & Webhooks
Build on top of AgentWorks
Programmatic access to every agent, conversation, and workspace event. Automate agent runs, embed results in your own product, or build internal tooling.
Key endpoints
Subscribe to events
Receive real-time notifications when a run completes, an approval is requested, or a budget threshold is hit.
POST /v1/workspaces/{id}/webhooksRead conversation history
Fetch conversation threads, individual messages, and attached agent outputs for downstream processing or compliance archiving.
GET /v1/workspaces/{id}/conversationsWorkspace-scoped credentials
API keys are scoped to a single workspace and carry only the permissions you define. Rotate or revoke any key without downtime.
Authorization: Bearer <workspace-api-key>Security & compliance
Built for regulated teams
All API calls are authenticated with workspace-scoped keys, logged to the immutable audit trail, and rate-limited per plan. OpenAPI specs are shared with active customers and qualified evaluations.
What teams build with the API
- Embed an AI agent into your own product UI without building the model layer
- Sync agent run results to your data warehouse or BI tool automatically
- Trigger compliance agents as part of your CI/CD or document approval pipeline
- Build internal dashboards that show live token usage and agent activity