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 that will not go forward, for example one declined or
not taken up, and cancels its open quotes. Use it, not Update Entity
(updateEntity); Reopen Submission (reopenSubmission) reverses it.
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"
]
}