Rename or Move Folder

Renames a folder, moves it to a different parent, or both. Send only the fields you want to change.

Set parentFolderId to a folder ID to move the folder, or to null to move it to the root level.

Required permission: company.file:update

PATCH /api/v1/external/companies/{companyId}/folders/{folderId}

cURL

rename

curl --request PATCH \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/folders/{folderId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Archived Claims"
}
'

200

success

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "name": "Archived Claims",
  "parentFolderId": null,
  "category": null,
  "createdAt": "2026-01-15T10:30:00.000Z"
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

folderId · string<uuid> · required

Folder identifier

Body

application/json

name · string

New folder name (non-empty)

parentFolderId · string<uuid> | null

New parent folder ID, or null to move to root

Response

200

application/json

Folder updated successfully

A folder in the company file hierarchy

id · string<uuid>

Folder identifier

name · string

Folder name

category · string | null

Optional category label

parentFolderId · string<uuid> | null

Parent folder ID, or null for root-level folders

createdAt · string<date-time> | null

When the folder was created (ISO 8601)