---
title: "Update Playbook Task Status"
method: PUT
path: "/api/v1/playbook-tasks/{task_id}/status"
tags: ["playbooks"]
---

# Update Playbook Task Status

`PUT /api/v1/playbook-tasks/{task_id}/status`

## Path parameters

- `task_id` string, uuid, required

## Request body

- PlaybookTaskStatusUpdate — Mark a GM task done or reopen it.
  - `status` 'open' | 'done', required — A GM task raised by a Playbook: to-do (open) or done.

## Response `200`

Successful Response

- PlaybookTaskRead — A GM task raised by a Playbook, with the guest resolved for display.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `customer_profile_id` string, uuid, nullable
  - `booking_record_id` string, uuid, nullable
  - `customer_name` string, nullable
  - `list_id` string, uuid, nullable
  - `source_playbook_id` string, uuid, nullable
  - `source_run_id` string, uuid, nullable
  - `title` string, required
  - `body` string, nullable
  - `category` string, nullable
  - `source_label` string, nullable
  - `highlight_span` string, nullable
  - `property_id` string, uuid, nullable
  - `property_name` string, nullable
  - `due_at` string, date-time, nullable
  - `department` string, nullable
  - `assignee_kind` string
  - `owner_label` string, nullable
  - `blocked` boolean
  - `priority` string, nullable
  - `status` 'open' | 'done', required — A GM task raised by a Playbook: to-do (open) or done.
  - `assigned_user_id` string, uuid, nullable
  - `completed_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, required
  - `completable` boolean

## Other responses

- `404` — Task not found
- `422` — Validation Error

## Changes

> 20 revisions in range; 1 not diffed.

- **2026-09-12** `0e71c3cd9536` — 1 info
  - added the optional property `highlight_span` to the response with the `200` status
- **2026-09-09** `14d0341c60b5` — 2 breaking
  - the response property `created_at` became optional for the status `200`
  - response property `created_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/playbook-tasks/:task_id/status/put.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/dabff0d3c9ff?raw)