curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/folders \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"entityType": "company",
"name": "Claims Documents"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440001"
}Create Folder
Creates a folder under an owner — a configured entity (entityType +
entityId) or the company level (entityType: "company", no
entityId). Optionally nest it under one of the owner’s existing
folders with parentFolderId; omit it for a top-level folder. A folder
can only ever contain files and subfolders of its own owner.
Optionally label it with category, which must be one of the owner
type’s configured categories — any other value is a 400. Omit it (or
send null) for an uncategorized folder.
Required permission: file.upload
curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/folders \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"entityType": "company",
"name": "Claims Documents"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440001"
}Authorizations
API key authentication. Send your raw API key as the Authorization header value with NO scheme prefix — Authorization: YOUR-API-KEY. Do NOT prefix it with Bearer or ApiKey, and do not use an X-API-Key header; those are not accepted.
Path Parameters
Company identifier
Body
The folder owner's entity type
event, exposure, quote, submission, person, organization, policy, company Folder name (must be non-empty)
The owner entity's id. Required for every entityType
except company (omit or send null for company-level folders).
Parent folder to nest under (omit or null for top-level)
Category label for the folder — must be one of the owner type's configured categories. Omit or null for none.
Response
Folder created successfully
Id of the created folder