List webhooks
/api/webhooksEvery webhook, with its delivery state. Never the secret.
Needs the ManageApiKeys permission.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/webhooks"{ "webhooks": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "url": "string", "eventTypes": [ "string" ], "subjectIds": [ "string" ], "enabled": true, "ownerId": "4d206909-730f-409a-88f6-dcfaa8fc28cc", "ownerName": null, "canEdit": true, "createdAt": "2019-08-24T14:15:22Z", "lastSuccessAt": null, "failingSince": null, "lastError": null, "nextAttemptAt": null, "disabledAt": null, "disabledReason": null, "state": "string" } ], "allowPrivateAddresses": true, "canChangeAllowPrivateAddresses": true}Event polling GET
Authenticate with `Authorization: Bearer mbk_...`. Returns events after `cursor` at once when there are any, up to `limit` (default 100, at most 500); otherwise waits up to `wait` seconds (default 30, at most 60) for one and returns an empty list. No cursor means from now. Send the returned `cursor` back; `more` means poll again straight away. `types` and `subjects` repeat or are comma-separated. Field names in the answer are snake_case (`type_raw`, `occurred_at`, `world_id`); the keys inside an event's `data` are camelCase. See https://docs.modbot.co/api/long-polling/.
Add webhook POST
The response carries the signing secret. It is shown this once. Needs the `ManageApiKeys` permission.