Send events into your agents.
One authenticated endpoint, one Access Key. POST a JSON event scoped to an agent and your agent receives it — whether it's a conversational agent or a workflow.
POST https://webhook.olbrain.com/api/agents/webhook/agt_01HAKZ...
Authorization: Bearer ak_<your-access-key>
Content-Type: application/json
{ "message": "Order #4421 placed" }Where to go next
Quickstart
Mint an Access Key, fire your first webhook in under two minutes, see the agent respond.
Start →Authentication
How ak_* Access Keys work, how to mint them, and how to revoke them.
Trigger a webhook
The single POST endpoint. Body shape, size limits, headers, retry semantics, and routing rules.
Read →File uploads
Stream large files (> 32 MiB) via multipart and reference them by fi_* id in your webhook body.
Run management
List, inspect, pause, resume, cancel, and retry workflow runs from outside Studio.
Read →Errors
Every status code you'll see, what it means, and how to fix the request that caused it.
Read →What you can do
- Trigger — send a JSON event and have your agent process it, or kick off a workflow run.
- Upload — send a file larger than 1 MiB and reference it by id from your event body.
- Inspect — list runs and fetch a single run with signed URLs to its outputs.
- Control — pause, resume, retry, or cancel a run from your own code.
Run management endpoints are workflow-only. Conversational agents have no runs to pause or resume.
Base URL
A single HTTPS endpoint serves all webhook traffic. All requests must use TLS.