curl --request PUT \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/intended-layer \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"intendedLayer": "invoicing"
}
'{
"quoteId": "550e8400-e29b-41d4-a716-446655440002",
"intendedLayer": "invoicing"
}Set Quote Intended Layer
Quote door. Saves the layer of the
pricing stack
the quote is meant to bind at, or clears the choice with null. Only
the intended layer is written: the quote’s fields, its invoice settings
and plan, and its rating stay as they are. Choosing a layer changes
nothing else on the quote; you make its pricing, billing and invoices
match it.
The body is intendedLayer. It may also carry quoteId, so a
Get Quote Intended Layer
response can be sent back as it is; that quoteId must be the path’s.
Binds do not check the intended layer yet: Bind Quote, Check Bind Conditions and Complete behave the same whatever it says.
Refusals. An intendedLayer that is missing or is not one of the
four layers, an unknown field, or a quoteId other than the path’s
returns 400. With policy invoicing disabled, this returns
403 finv2-policy-invoicing-disabled. A bound or cancelled quote returns
409: its intended layer can no longer change. Nothing is saved on a
refusal. Every quote type takes one: new business, renewal, endorsement,
cancellation and reinstatement.
Required permission: quote.edit
curl --request PUT \
--url https://go.aiinsurance.io/api/v1/companies/{companyId}/quotes/{quoteId}/intended-layer \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"intendedLayer": "invoicing"
}
'{
"quoteId": "550e8400-e29b-41d4-a716-446655440002",
"intendedLayer": "invoicing"
}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
Quote identifier
Body
The body of Set Quote Intended Layer: the layer to save, or null to clear the choice. A Get Quote Intended Layer response can be sent back as it is.
Response
The quote's intended layer as saved.
A quote's intended layer: the layer of the pricing stack the quote is meant to bind at, or null while none is chosen. Get Quote Intended Layer and Set Quote Intended Layer both return this.