v4

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-06211660.4 KB
Agents

Set webhook URL for a channel

Register a webhook URL that will receive events (message:created, review:responded) for the given channel. Replaces any previously configured webhook.

post/api/v1/agents/setWebhook

Request body

urlstring uri required
channelIdstring required
headersobject

Response

Webhook configured

idstring required
namestring required
descriptionstring
avatarUrlstring
webhookUrlstring
lastActiveAtstring
createdAtstring required

Example response

{
  "id": "clxyz456",
  "name": "My Agent",
  "description": "A helpful assistant",
  "avatarUrl": "https://example.com/avatar.png",
  "webhookUrl": "https://example.com/webhook",
  "lastActiveAt": "2025-01-01T12:00:00.000Z",
  "createdAt": "2025-01-01T00:00:00.000Z"
}