---
title: "Preview document moves"
method: POST
path: "/document_organization/previews"
tags: ["document_organization"]
---

# Preview document moves

`POST /document_organization/previews`

Requires folders_view_enabled. Computes effective user-level and durable Team/Tenant audience increases and decreases for an atomic move or unfile. Each change includes document_uuid, document_name, audience_type (User/Team/Tenant), audience_uuid, audience_name, before_level, after_level and direction; User rows also include user_uuid and user_name. Layouts retain tenant-wide view access.

## Request body

- object
  - `document_uuids` string[], required — Selected document UUIDs (maximum 100)
  - `folder_uuid` string — Destination folder UUID, or null to unfile

## 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-16** `786a880e3372` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/changes/document_organization/previews/post.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.dev/rhythms/apis/rhythms-params-in-body/revisions/be444d98d5ff?raw)