List the tenant's comms webhook channels for step notifications (tenant:settings:read)
GET /api/workflow/v1/channels
Module: Workflow · operationId: listWebhookChannels · Tag: Blueprints · Auth: access token (Authorization: Bearer <accessToken>)
The channels a step can name as teamsChannel. URLs are never returned. Empty when comms is not configured.
Responses
- 200 Channels (
application/json) - 401 Missing or invalid token (
unauthorized) (application/json) - 403 Error (
application/json) - 503 Error (
application/json)
Fields of the 200 answer:
items(array of WebhookChannel, required): Items of the listformat(string): Payload format of the channel (one ofjson_event,teams_card)id(string): Channel id, used as a step'steamsChannelname(string): Channel namestatus(string): Status of the channel in comms
total(integer): Number of items
Example 200 answer:
{
"items": [
{
"format": "teams_card",
"id": "9c4e2b7a-1d3f-4a6b-8c5d-2e7f9a1b3c4d",
"name": "Teams-Kanal Buchhaltung",
"status": "active"
}
],
"total": 1
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/workflow/v1/channels' \
-H "Authorization: Bearer $ACCESS_TOKEN"