---
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
  - `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, required
  - `updated_at` string, date-time, required
  - `completable` boolean

## Other responses

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

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/3ad158624c53/schema)