Start Quote Run

POST/v1/quotes/:id/start

Dispatches AI agents against every staged job on the quote request. One job runs per carrier per line of business, in parallel. Results are returned asynchronously.

Request

POST /v1/quotes/qr_01HV.../start
Authorization: Bearer qs_live_xxxxx
Content-Type: application/json

{}

The carrier selection was fixed when the request was created. This call takes no body fields in v1; it starts every job still in standby.

Response 202 Accepted

{
  "success": true,
  "data": {
    "quoteRequestId": "qr_01HV...",
    "status": "in_progress",
    "startedCount": 5,
    "startedAt": "2026-08-25T14:03:03Z"
  }
}

startedCount counts jobs moved out of standby. Calling start again is safe — jobs already running are not restarted, and a request with nothing left to start returns startedCount: 0.

Rejections

Value	Retriable	Description

Expect minutes, not seconds

Each carrier is worked by an AI agent driving that carrier's portal. Elapsed time tracks the slowest selected carrier and commonly runs to several minutes. A run can finish partially, with some carriers quoted while others fail or wait on agent input. Never block a user-facing request on completion.

Next step

Track progress with GET /v1/quotes/:id, or register a webhook to be pushed updates as each carrier finishes.