Confirm the user's selection, capture credit consent, and start the chat-native bind continuation flow.

Pass the selected selection_token, a final user confirmation, and the credit_consent block collected from the real user. Coverage Cat requires the affirmative Yes to the soft-credit pull before binding a chosen offer; if it is missing or declined the response is credit_consent_required with the prompt to render. Otherwise Coverage Cat will either return the next bind-stage next_question to keep collecting required details in chat, or it will continue the standard post-choose workflow and tell the agent to keep polling status in chat. For Monoline and Markel, the post-choose workflow may require declarations uploads first; once those uploads are on file, documents_pending_review usually advances to payment_needed with a secure payment_url within about 5-10 minutes while declarations verification continues in parallel. Successful post-choose responses include offers_url, and may include required_upload_types or a secure payment_url. Sandbox delegated umbrella sessions reject this endpoint with sandbox_unsupported.

post/api/agent/umbrella/select

Request

  • Base URL: https://api.coveragecat.com
  • URL: https://api.coveragecat.com/api/agent/umbrella/select
  • Auth: HTTP bearer

Headers

Coverage-Cat-API-Version'v1'

Optional explicit Coverage Cat API version selector. Omit the header to use the current stable version.

Idempotency-Keystring

Optional idempotency key for consumer or operator write requests. Coverage Cat replays the cached successful response for the same subject, path, and key for 24 hours, and rejects a changed payload under the same key.

Request body

sandboxboolean

Optional sticky sandbox flag. Sandbox delegated umbrella sessions currently reject select with sandbox_unsupported; this field is accepted so a client carrying the same request envelope does not fail schema validation first.

selection_confirmedtrue required
selection_tokenstring required
uidstring required

Response

Offer selection accepted.

agent_instructionsstring[]
credit_consent_questionstring

Present only when status is credit_consent_required. The real user's affirmative Yes must be collected and passed back on the next select call as credit_consent.

offers_urlstring uri

Secure link to the Coverage Cat offers page for this delegated session.

payment_urlstring uri

Secure payment-setup link, returned only when Coverage Cat is ready to collect payment.

post_chooseobject
required_upload_typesstring[]
response_summarystring
status'credit_consent_required' | 'needs_more_info_to_bind' | 'documents_needed' | 'documents_pending_review' | 'payment_needed' | 'chosen'
uidstring

Changes

No recorded changes to this operation across all 1 revision of this API.