PATCH /quotes/{id}/items/{itemId}

PATCH/quotes/{id}/items/{itemId}

scopequotes:writereturns200rate limit30 / min

Decide an item with recipients

Same decision cascade as the action endpoint, with two extras: `alternative_id` targets one of the item's alternatives, and `recipients` (required on accept) replaces the item's recipient list before the decision runs.

Body

actionrequired

"accept" | "reject"The decision. Case-sensitive - exactly `accept` or `reject`.

alternative_id

stringApply the decision to this alternative of the item (must belong to it).

recipients

object[]Required when action is accept. Replaces the item recipients. Each needs `name` and `country` — or pass `office_id` (GET /api/v1/offices) to ship to a saved office instead. A slot that names no new office_id or address keeps an existing office destination. email, address, phone_number, phone_country_code, hire_date, storage, comments, recipient_id are optional.

Example request

json

{
  "action": "accept",
  "recipients": [
    {
      "name": "Alex Doe",
      "email": "alex@acme.com",
      "country": "United States",
      "address": "123 Market St, San Francisco, CA 94103"
    }
  ]
}

Example response

json

{
  "data": {
    "id": "8a2b1c3d-4e5f-6071-8293-a4b5c6d7e8f9",
    "type": "item",
    "status": "accepted"
  }
}