curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/submissions/{submissionId}/close \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{}'{
"submissionId": "550e8400-e29b-41d4-a716-446655440030",
"closedQuoteIds": [
"550e8400-e29b-41d4-a716-446655440031"
]
}Close Submission
Closes a submission in one transaction. Every active quote on the
submission (inProgress or complete) is cancelled, the submission moves
to closed, and the optional close reason and explanation are stored when
those fields exist in the Company’s configuration.
Use this action instead of changing submissionStatus through the generic
entity endpoint. That field is system-managed, so a generic status
transition returns 409 GuardedStatusFieldWrite.
A submission that contains a bound quote cannot be closed. Closing an already-closed submission is also a strict conflict; neither case partially cancels quotes or changes the submission.
Required permission: submission.close
curl --request POST \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/submissions/{submissionId}/close \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{}'{
"submissionId": "550e8400-e29b-41d4-a716-446655440030",
"closedQuoteIds": [
"550e8400-e29b-41d4-a716-446655440031"
]
}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
The submission's unique identifier.
Body
Optional key from the tenant's Close Reason option set. It is
stored only when Submission::closeReason is configured.
1Optional free-text explanation. It is stored only when
Submission::closeExplanation is configured.
1