List channel routes

GET

/channels/:channelId/routes

Returns the channel’s active routes (oldest first). Requires trigger:manage.

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

channelIdstringRequired

The channel's routes.

routeslist of objects

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

1	{
2	"routes": [
3	{
4	"_id": "64b8f9a2e4b0c123456789ab",
5	"channelId": "channel_987654321",
6	"name": "Customer Support Route",
7	"target": {
8	"kind": "playbook",
9	"playbookId": "playbook_123abc",
10	"projectId": "project_456def"
11	},
12	"payloadMapping": {
13	"customerId": "{{payload.user.id}}",
14	"issueType": "{{payload.issue.type}}"
15	},
16	"status": "active",
17	"createdAt": "2024-05-20T09:15:00Z",
18	"archivedAt": null
19	}
20	]
21	}

1	curl https:/https://api/channels/channelId/routes \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json"