Change a proposal
patch/proposals/{id}
Change a proposal; fields left out stay as they are. A sent proposal becomes a new revision and goes back to draft.
Before you call
- Credential
Authorization: Bearer $KEY- Scope
shop:write- Mcp
rivier_proposals_update- Graphql
Mutation.shopProposalUpdate- Sdk
shop.proposal.update- Cli
proposals update
Parameters
- idstring (uuid)requiredIn the path
Request bodyapplication/json, required
- clientIdstring (uuid) or null
- contactobject
- namestringrequiredAt most 200 characters.
- emailstring (email)At most 254 characters.
- phonestringAt most 60 characters.
- addressLineslist of stringDefault: [].
- countrystringPattern: ^[A-Z]{2}$.
- vatIdstringAt most 60 characters.
- registrationstringAt most 60 characters.
- languagestringAt most 20 characters. Pattern: ^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$.
- namestringrequired
- recipientsobject
- tolist of objectDefault: [].
- namestringDefault: . At most 200 characters.
- emailstring (email)requiredAt most 254 characters.
- contactIdstring (uuid)
- namestring
- cclist of objectDefault: [].
- namestringDefault: . At most 200 characters.
- emailstring (email)requiredAt most 254 characters.
- contactIdstring (uuid)
- namestring
- tolist of object
- currencystringPattern: ^[a-z]{3}$.
- languagestringAt most 20 characters. Pattern: ^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$.
- titlestringAt most 200 characters.
- issueDatestringPattern: ^\d{4}-\d{2}-\d{2}$.
- validUntilstringPattern: ^\d{4}-\d{2}-\d{2}$.
- notesstringAt most 4000 characters.
- termsstringAt most 10000 characters.
- paymentInstructionsstringAt most 2000 characters.
- templateIdstring (uuid) or null
- layoutstringOne of: minimal, classic, modern, bold.
- taxInclusiveboolean
- lineslist of object
- descriptionstringrequiredAt most 500 characters.
- quantitynumberDefault: 1. At most 1000000.
- unitstringDefault: C62. At most 10 characters.
- unitAmountMinorintegerrequiredAt least 0. At most 99999999999.
- discountMinorintegerDefault: 0. At least 0. At most 99999999999.
- taxRateBpintegerAt least 0. At most 10000.
- taxCategorystringOne of: S, Z, E, AE, K, G, O, L, M. Default: S.
- optionalbooleanDefault: false.
- selectedbooleanDefault: true.
- descriptionstringrequired
- subjectstringAt most 300 characters.
- messagestringAt most 5000 characters.
- useCasestringAt most 80 characters.
- sectionslist of object
- keystringrequiredOne of: scope, deliverables, timeline, pricing, terms, custom.
- titlestringDefault: . At most 120 characters.
- bodystringDefault: . At most 20000 characters.
- itemslist of objectDefault: [].
- labelstringrequiredAt most 300 characters.
- detailstringDefault: . At most 1000 characters.
- whenstringDefault: . At most 60 characters.
- labelstringrequired
- keystringrequired
- expectedVersionintegerAt least 1.
Responses
- 200application/jsonSuccess
- idstring (uuid)required
- kindstringrequiredOne of: quote, proposal.
- organizationIdstring (uuid)required
- clientIdstring (uuid) or nullrequired
- numberstring or nullrequired
- statusstringrequiredOne of: draft, sent, viewed, accepted, declined, expired, void, converted.
- currencystringrequired
- languagestringrequired
- titlestringrequired
- issueDatestring or nullrequired
- validUntilstring or nullrequired
- subtotalMinornumberrequired
- taxMinornumberrequired
- totalMinornumberrequired
- revisionnumberrequired
- versionnumberrequired
- convertedKindstring or nullrequired
- convertedIdstring (uuid) or nullrequired
- acceptedAtstring or nullrequired
- acceptedNamestring or nullrequired
- declinedAtstring or nullrequired
- sentAtstring or nullrequired
- viewedAtstring or nullrequired
- voidedAtstring or nullrequired
- createdBystringrequired
- createdAtstringrequired
- updatedAtstringrequired
- 400application/jsonThe request was malformed
- errorstringrequired
- messagestring
- 401application/jsonNo valid credential
- errorstringrequired
- messagestring
- 403application/jsonThe credential lacks the scope, origin or address
- errorstringrequired
- messagestring
- 429application/jsonOver the key's rate limit; see Retry-After
- errorstringrequired
- messagestring