---
title: "File a document into a folder"
method: PUT
path: "/documents/{uuid}/folder_assignment"
tags: ["folder_assignments"]
---

# File a document into a folder

`PUT /documents/{uuid}/folder_assignment`

Files the document into the folder (single-home: moves it if it was already filed elsewhere) and grants folder members view access to it.

## Path parameters

- `uuid` string, required

## Request body

- object
  - `folder_assignment` object, required
    - `folder_uuid` string, required — Target folder UUID

## 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

## Changes

- **2026-09-04** `ae49732995e4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/changes/documents/:uuid/folder_assignment/put.md)

---

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