---
title: "Get playbook run channels"
method: GET
path: "/plugins/playbooks/api/v0/runs/channels"
tags: ["PlaybookRuns"]
---

# Get playbook run channels

`GET /plugins/playbooks/api/v0/runs/channels`

Get all channels associated with a playbook run, filtered by team, status, owner, name and/or members, and sorted by ID, name, status, creation date, end date, team, or owner ID.

## Query parameters

- `team_id` string, required
- `sort` 'id' | 'name' | 'create_at' | 'end_at' | 'team_id' | 'owner_user_id'
- `direction` 'desc' | 'asc'
- `status` 'all' | 'InProgress' | 'Finished'
- `owner_user_id` string
- `search_term` string
- `participant_id` string

## Response `200`

Channel IDs.

- string[]

## Other responses

- `400` — The request is malformed.
- `403` — Access to the resource is forbidden for this user.
- `500` — There was an internal error in the server.

---

[API](https://skmtc.net/mattermost/apis/playbooks-api.md) · [All operations](https://skmtc.net/mattermost/apis/playbooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mattermost/playbooks-api/revisions/3b509bbdf17e/schema)