Rename or Move File

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

Set folderId to a folder ID to move the file into that folder, or to null to remove it from its current folder (move to root).

Required permission: company.file:update

PATCH /api/v1/external/companies/{companyId}/files/{fileId}

cURL

rename

curl --request PATCH \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/files/{fileId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "claim-report-final.pdf"
}
'

200

success

{
  "id": "550e8400-e29b-41d4-a716-446655440020",
  "name": "claim-report-final.pdf",
  "mimeType": "application/pdf",
  "category": "claims",
  "entityId": null,
  "entityName": null,
  "uploadedAt": "2026-01-20T09:15:00.000Z",
  "userDate": null
}

Authorizations

Authorization · string · header · required

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

Path Parameters

companyId · string<uuid> · required

Company identifier

fileId · string<uuid> · required

File identifier

Body

application/json

name · string

New file name

folderId · string<uuid> | null

New folder ID, or null to move to root

Response

200

application/json

File updated successfully

A file stored in the company file system

id · string<uuid>

File identifier

name · string

File name

mimeType · string | null

MIME type of the file

category · string | null

Optional category label

entityId · string | null

Related entity ID (if attached to an entity)

entityName · string | null

Related entity name (if attached to an entity)

uploadedAt · string<date-time> | null

When the file was uploaded (ISO 8601)

userDate · string<date-time> | null

User-specified date for the file (ISO 8601)