---
title: "Rename files"
method: POST
path: "/files/rename"
tags: ["Files"]
---

# Rename files

`POST /files/rename`

## Request

- Base URL: `https://api.livereacting.com/v1/external`
- URL: `https://api.livereacting.com/v1/external/files/rename`
- Auth: HTTP bearer

Rename one or more files. Accepts an array of file ID and name pairs (1-700 items).
Returns partial success — files that could not be renamed appear in the `failed` array.
Duplicate file IDs in the same request are rejected.

## Request body

- RenameFilesRequest
  - `files` object[], required: Array of file rename operations (1-700 items)
    - `fileId` string, required: ID of the file to rename
    - `name` string, required: New name for the file (max 255 chars)

## Response `200`

Rename results (partial success possible)

- RenameFilesResponse
  - `renamed` object[]: Files successfully renamed
    - `fileId` string: ID of the renamed file
    - `name` string: New name (trimmed)
  - `failed` object[]: Files that failed to rename
    - `fileId` string: ID of the file
    - `reason` 'not_found' | 'invalid_name' | 'unknown': Reason for failure
    - `message` string: Detailed error message (present for invalid_name)
  - `message` string: Summary message

## Other responses

- `400`: Validation error
- `401`: Authentication failed
- `429`: Rate limit exceeded

---

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