curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/tasks \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Review claim documents",
"deadline": "2026-07-01T17:00:00.000Z"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440300"
}Create Task
Creates a to-do (task, diary item) with a deadline, optionally assigned to
company users and linked to a record such as a claim. To link it, send
entity with the record’s id and a type label the app shows a link
for: Claim, Incident or Event for an event, Insured for an
exposure, or Policy. For a dated record of what happened, use Create Note
(createNote) instead.
Creates a new task for the company.
assignees must reference users in the same company — a non-member user ID
is rejected with a 400 error. List Company Members returns the IDs
of the company’s members.
Required permission: task.create
curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/tasks \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Review claim documents",
"deadline": "2026-07-01T17:00:00.000Z"
}
'{
"id": "550e8400-e29b-41d4-a716-446655440300"
}Authorizations
Headers
Optional key that makes a retry of this operation safe. Send a new value, 1 to 255 printable ASCII characters, for each intended operation, and send the same value with the same request when you retry it. A committed attempt reserves the key for 30 days from admission; retries do not extend that window. After 30 days the same key runs as a new request, even if its body differs. Within that window, a retry after the first request completed returns the original resource or run identity with the same status and response shape, without starting another operation. A failure before the intent commits stores nothing; after an external effect fails, a retry may resume that same committed intent. Keys belong to the credential, so another API key, even one the same user created, cannot replay them. Within 30 days, reusing a key with a different request returns 422 IDEMPOTENCY_KEY_REUSED; an invalid key returns 400 INVALID_IDEMPOTENCY_KEY. The key is compared exactly, so case and surrounding spaces count.
1 - 255^[\x20-\x7E]{1,255}$Body
Company user IDs to assign the task to: member ids from List Company Members.