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

# Get a playbook run

`GET /plugins/playbooks/api/v0/runs/{id}`

## Path parameters

- `id` string, required

## Response `200`

Playbook run

- PlaybookRun
  - `id` string — A unique, 26 characters long, alphanumeric identifier for the playbook run.
  - `name` string — The name of the playbook run.
  - `summary` string — The summary of the playbook run.
  - `is_active` boolean — True if the playbook run is ongoing; false if the playbook run is ended.
  - `owner_user_id` string — The identifier of the user that is commanding the playbook run.
  - `team_id` string — The identifier of the team where the playbook run's channel is in.
  - `channel_id` string — The identifier of the playbook run's channel.
  - `create_at` integer — The playbook run creation timestamp, formatted as the number of milliseconds since the Unix epoch.
  - `end_at` integer — The playbook run finish timestamp, formatted as the number of milliseconds since the Unix epoch. It equals 0 if the playbook run is not finished.
  - `delete_at` integer — The playbook run deletion timestamp, formatted as the number of milliseconds since the Unix epoch. It equals 0 if the playbook run is not deleted.
  - `active_stage` integer — Zero-based index of the currently active stage.
  - `active_stage_title` string — The title of the currently active stage.
  - `post_id` string — If the playbook run was created from a post, this field contains the identifier of such post. If not, this field is empty.
  - `playbook_id` string — The identifier of the playbook with from which this playbook run was created.
  - `checklists` Checklist[]
    - `id` string — A unique, 26 characters long, alphanumeric identifier for the checklist.
    - `title` string — The title of the checklist.
    - `items` ChecklistItem[] — The list of tasks to do.
      - `id` string — A unique, 26 characters long, alphanumeric identifier for the checklist item.
      - `title` string — The title of the checklist item.
      - `state` '' | 'in_progress' | 'closed' — The state of the checklist item. An empty string means that the item is not done.
      - `state_modified` integer — The timestamp for the latest modification of the item's state, formatted as the number of milliseconds since the Unix epoch. It equals 0 if the item was never modified.
      - `assignee_id` string — The identifier of the user that has been assigned to complete this item. If the item has no assignee, this is an empty string.
      - `assignee_modified` integer — The timestamp for the latest modification of the item's assignee, formatted as the number of milliseconds since the Unix epoch. It equals 0 if the item never got an assignee.
      - `command` string — The slash command associated with this item. If the item has no slash command associated, this is an empty string
      - `command_last_run` integer — The timestamp for the latest execution of the item's command, formatted as the number of milliseconds since the Unix epoch. It equals 0 if the command was never executed.
      - `description` string — A detailed description of the checklist item, formatted with Markdown.
      - `delete_at` integer — The timestamp for the last time the item was skipped, formatted as the number of milliseconds since the Unix epoch. It equals 0 if the item was never skipped.
      - `due_date` integer — The timestamp for the due date of the checklist item, formatted as the number of milliseconds since the Unix epoch. It equals 0 if not set. For playbooks, this is a relative timestamp; for runs, this is an absolute timestamp.
      - `task_actions` object[] — An array of all the task actions associated with this task. Enabled mark-as-done message triggers are mutually exclusive with requirements on the same checklist item.
        - `trigger` object — The trigger configuration for the task action.
        - `actions` object[] — The actions to be executed when the trigger is activated.
      - `requirements` TaskRequirement[] — Labeled fields that must be filled when checking off this task in a run. Only used when the task requirements beta feature is enabled. Mutually exclusive with enabled mark-as-done message triggers on the same item. On playbook writes, requirement values are cleared so templates do not prefill run values.
        - `id` string — A unique identifier for the requirement field.
        - `label` string — The label shown to users when filling this requirement.
        - `value` string — The filled value for this requirement on a run. Empty on playbook templates.
      - `update_at` integer — The timestamp for when this checklist item was last modified, formatted as the number of milliseconds since the Unix epoch.
      - `condition_id` string — The ID of the condition that created this checklist item, if any. Empty string if the item was not created by a condition.
      - `condition_action` '' | 'hidden' | 'shown_because_modified' — A string that represents the action created as a result of a condition evaluation. Empty string means no action, 'hidden' means the item is hidden due to condition not being met, 'shown_because_modified' means the item is shown despite condition not being met because it was recently modified.
      - `condition_reason` string — A string representation of the condition that affects this checklist item. Empty string if no condition is associated with this item.

## Other responses

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

## Changes

- **2026-08-25** `2acd884508c4` — 1 info
  - added the optional property `checklists/items/items/items/requirements` to the response with the `200` status
- **2026-01-22** `7cc35d281cdf` — 1 warning, 1 info
  - removed the optional property `description` from the response with the `200` status
  - added the optional property `summary` to the response with the `200` status
- **2025-10-13** `3b1944780f92` — 7 info
  - added the optional property `checklists/items/items/items/condition_action` to the response with the `200` status
  - added the optional property `checklists/items/items/items/condition_id` to the response with the `200` status
  - added the optional property `checklists/items/items/items/condition_reason` to the response with the `200` status
  - added the optional property `checklists/items/items/items/delete_at` to the response with the `200` status
  - …3 more
- **2023-06-19** `148981c0ea86` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mattermost/apis/playbooks-api/changes/plugins/playbooks/api/v0/runs/:id/get.md)

---

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