---
title: "Update a playbook run's status"
method: POST
path: "/plugins/playbooks/api/v0/runs/{id}/status"
tags: ["PlaybookRuns"]
---

# Update a playbook run's status

`POST /plugins/playbooks/api/v0/runs/{id}/status`

## Path parameters

- `id` string, required

## Request body

- object
  - `message` string, required — The status update message.
  - `reminder` number — The number of seconds until the system will send a reminder to the owner to update the status. No reminder will be scheduled if reminder is 0 or omitted.

## Response `200`

Playbook run updated.

## 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/versions/3b509bbdf17e/schema)