Rename or Move Folder - AI Insurance

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"
}
'

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

PATCH

api

external

companies

{companyId}

folders

{folderId}

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"
}
'

{
  "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

Folder updated successfully

A folder in the company file hierarchy

string<uuid>

Folder identifier

name

string

Folder name