v46

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-174421106.5 KB

PlaybookRuns

Get a playbook run

get/plugins/playbooks/api/v0/runs/{id}

Path parameters

idstring required

Example:mx3xyzdojfgyfdx8sc8of1gdme

ID of the playbook run to retrieve.

Response

Playbook run

idstring

A unique, 26 characters long, alphanumeric identifier for the playbook run.

namestring

The name of the playbook run.

summarystring

The summary of the playbook run.

is_activeboolean

True if the playbook run is ongoing; false if the playbook run is ended.

owner_user_idstring

The identifier of the user that is commanding the playbook run.

team_idstring

The identifier of the team where the playbook run's channel is in.

channel_idstring

The identifier of the playbook run's channel.

create_atinteger

The playbook run creation timestamp, formatted as the number of milliseconds since the Unix epoch.

end_atinteger

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_atinteger

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_stageinteger

Zero-based index of the currently active stage.

active_stage_titlestring

The title of the currently active stage.

post_idstring

If the playbook run was created from a post, this field contains the identifier of such post. If not, this field is empty.

playbook_idstring

The identifier of the playbook with from which this playbook run was created.

Example response

{
  "id": "mx3xyzdojfgyfdx8sc8of1gdme",
  "name": "Server down in EU cluster",
  "summary": "There is one server in the EU cluster that is not responding since April 12.",
  "owner_user_id": "bqnbdf8uc0a8yz4i39qrpgkvtg",
  "team_id": "61ji2mpflefup3cnuif80r5rde",
  "channel_id": "hwrmiyzj3kadcilh3ukfcnsbt6",
  "create_at": 1606807976289,
  "active_stage": 1,
  "active_stage_title": "Triage issue",
  "post_id": "b2ntfcrl4ujivl456ab4b3aago",
  "playbook_id": "0y4a0ntte97cxvfont8y84wa7x",
  "checklists": [
    {
      "id": "6f6nsgxzoq84fqh1dnlyivgafd",
      "title": "Triage issue",
      "items": [
        {
          "id": "6f6nsgxzoq84fqh1dnlyivgafd",
          "title": "Gather information from customer.",
          "state": "closed",
          "state_modified": 1607774621321,
          "assignee_id": "pisdatkjtdlkdhht2v4inxuzx1",
          "assignee_modified": 1608897821125,
          "command": "/opsgenie on-call",
          "command_last_run": 1608552221019,
          "description": "Ask the customer for more information in [Zendesk](https://www.zendesk.com/).",
          "delete_at": 1607774621321,
          "due_date": 1607774621321,
          "update_at": 1607774621321,
          "condition_id": "6f6nsgxzoq84fqh1dnlyivgafd",
          "condition_action": "hidden",
          "condition_reason": "Severity is Critical AND Status is not Closed"
        }
      ]
    }
  ]
}