---
title: "Update document properties"
method: PUT
path: "/documents/{uuid}"
tags: ["documents"]
---

# Update document properties

`PUT /documents/{uuid}`

Update document properties including status, name, instructions, and layout association.

Use this endpoint to:
- Update the document name
- Update instructions
- Change the document status (completed, draft, published, archived)
- Associate the document with a layout (e.g., after saving a new layout from a custom document)

At least one parameter (name, instructions, status, or layout_uuid) must be provided.

## Path parameters

- `uuid` string, required

## Request body

- object
  - `name` string — Document name
  - `instructions` string — Instructions content for the document. Changing this triggers content regeneration.
  - `status` string — Document status: 'completed', 'draft', 'published', or 'archived'.
  - `content_type` string — Document type: 'document' or 'layout'
  - `layout_uuid` string — Simple UUID of the layout to associate with this document

## Other responses

- `400` — Bad Request - Invalid parameters or malformed request
- `401` — Unauthorized - Invalid or missing authentication
- `403` — Forbidden - User lacks permission to access this resource
- `404` — Not Found - Resource does not exist
- `422` — Unprocessable Entity - Invalid request parameters or validation errors
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - Unexpected server error

---

[API](https://skmtc.net/rhythms/apis/rhythms-params-in-body.md) · [All operations](https://skmtc.net/rhythms/apis/rhythms-params-in-body/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rhythms/rhythms-params-in-body/revisions/a67e54becfe9/schema)