Skip to content
SolivioSolivioSolivio

Update an offer

PATCH
/api/offers/{offerId}
curl --request PATCH \
  --url https://example.com/api/offers/example \
  --header 'Content-Type: application/json' \
  --cookie better-auth.session_token=<better-auth.session_token> \
  --data '{ "name": "example", "customerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "customerName": "example", "status": "draft", "currency": "example", "items": [ { "id": "example", "productId": "example", "name": "example", "description": "example", "quantity": 1, "requestItem": "example", "rationale": "example", "matchSource": "exact", "matchScore": 1 } ], "unmatched": [ { "item": "example", "reason": "example" } ], "notes": [ "example" ], "discountPercent": 1, "discountAmount": 1 }'

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
offerId
required
string

Request Bodyrequired

Section titled “ Request Bodyrequired ”

Review edits to apply to the offer.

Media typeapplication/json

Review edits that can be applied to a generated offer draft.

object
name
string
>= 1 characters
customerId
string | null format: uuid
customerName
string | null
status
string
Allowed values: draft accepted rejected
currency
string
items
Array<object>

Editable fields for an offer item. Unit price and currency are read-only from the product catalog.

object
id
string
productId
string | null
name
string
description
string
quantity
number
> 0
requestItem
string
rationale
string
matchSource
string | null
Allowed values: exact semantic manual
matchScore
number | null
unmatched
Array<object>

Unmatched fragment before persistence (no row id).

object
item
required
string
>= 1 characters
reason
required
string
notes
Array<string>
discountPercent
number
<= 100
discountAmount
number

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

The updated offer.

Media typeapplication/json
object
offer
required

A draft or accepted offer for a customer request.

object
id
required
string
customerId
required
string | null
requestId
required
string | null
userId
required
string | null
name
required
string
status
required
string
Allowed values: draft accepted rejected imported
currency
required
string
discountPercent
required
number
<= 100
discountAmount
required
number
notes
required
Array<string>
kbArticles
Array<object>
default:

Knowledge base article referenced during offer generation.

object
articleId
required
string format: uuid
articleTitle
required
string
spaceId
required
string format: uuid
spaceName
required
string
relevance
required
string
unmatched
required
Array<object>

Persisted unmatched request fragment. reason may be empty for legacy rows.

object
item
required
string
>= 1 characters
reason
required
string
id
required
string format: uuid
position
integer
items
required
Array<object>

A product line item included in an offer.

object
id
string
offerId
string
productId
required
string | null
name
required
string
description
required
string
quantity
required
number
> 0
unitPriceNet
required
number
vatRate
required
number
unitGrossPrice
required
number
totalNet
required
number
totalGross
required
number
requestItem
required
string
rationale
required
string
matchSource
required
string | null
Allowed values: exact semantic manual
matchScore
required
number | null
position
required
integer
product

Product snapshot used to render an offer line without frontend fixture lookup.

object
id
required
string
sku
string
name
required
string
description
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
customerName
string | null
clientRequest
string | null
userName
string | null
Example
{
  "offer": {
    "id": "offer-demo-001",
    "status": "draft",
    "kbArticles": [],
    "items": [
      {
        "matchSource": "exact"
      }
    ]
  }
}

400

Section titled “ 400 ”

The request body did not match the offer update contract.

Media typeapplication/json

Standard API error payload.

object
error
required
object
code
required
string
message
required
string
issues
Array<string>
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "issues": [
      "example"
    ]
  }
}

401

Section titled “ 401 ”

No valid Better Auth session was present.

Media typeapplication/json

Returned when no valid Better Auth session is present.

object
error
required
string
Examplegenerated
{
  "error": "example"
}

404

Section titled “ 404 ”

The offer was not found.

Media typeapplication/json

Standard API error payload.

object
error
required
object
code
required
string
message
required
string
issues
Array<string>
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "issues": [
      "example"
    ]
  }
}