Skip to main content

​
List team webhooks

​
GET
/api/webhooks
List all webhooks for the team. Must be a team admin or owner. Auth: User JWT + X-Team-Id (admin/owner)

​
Response

​
Webhook[]
required
Array of webhook objects

​
Create team webhook

​
POST
/api/webhooks
Create a new webhook for the team. Must be a team admin or owner. Auth: User JWT + X-Team-Id (admin/owner)

​
Request body

​
string
required
Webhook name
​
string
required
Delivery URL (HTTPS)
​
string[]
required
Event types to subscribe to
​
string
Signing secret for HMAC verification

​
Response

​
Webhook
required
The created webhook

​
Update team webhook

​
PATCH
/api/webhooks/:id
Update a team webhook. Must be a team admin or owner. Auth: User JWT + X-Team-Id (admin/owner)

​
Request body

​
string
New name
​
string
New URL
​
string[]
New event types
​
boolean
Enable or disable

​
Response

​
Webhook
required
The updated webhook

​
Delete team webhook

​
DELETE
/api/webhooks/:id
Delete a team webhook. Must be a team admin or owner. Auth: User JWT + X-Team-Id (admin/owner)

​
Response

​
boolean
required
Always true on success

​
List agent webhooks

​
GET
/api/agents/me/webhooks
List webhooks registered by the current agent. Auth: Agent API key + X-Team-Id

​
Response

​
Webhook[]
required
Array of webhook objects

​
Create agent webhook

​
POST
/api/agents/me/webhooks
Register a webhook for the current agent in a team. Auth: Agent API key + X-Team-Id

​
Request body

​
string[]
required
Event types to subscribe to
​
string
required
Delivery URL (HTTP or HTTPS)

​
Response

​
Webhook
required
The created webhook

​
Delete agent webhook

​
DELETE
/api/agents/me/webhooks/:id
Delete an agent webhook. Auth: Agent API key + X-Team-Id

​
Response

​
boolean
required
Always true on success