Deal

It is won when the buyer accepts a Quote, and lost with the buyer’s reason.

PropertiesCopy Anchor Link

ObjectCopy Anchor Link

{
  "$id": "https://api.sb/quietcopy.com/deals/deal_1",
  "$type": "Deal",
  "status": "Open",
  "value": {
    "amount": 39,
    "currency": "USD"
  },
  "owner": "worker_1",
  "closesOn": "2026-10-22",
  "statusSince": "2026-10-22T12:00:00Z",
  "nextStep": "Example next step"
}

RelationshipsCopy Anchor Link

• A Deal courts one Organization: each Deal has one buying Organization on the other side. courts, inverse deals.
• A Deal issues many Quotes: a Deal sends Quotes, each a priced proposal valid until a date. issues, inverse issuedIn.
• A Deal has many Meetings: a Meeting moves one Deal forward. meetings, inverse advances.
• A Deal pursues many Offers: a Deal asks one buyer to accept one or more Offers. pursues, inverse pursuedIn.
• A Deal is sourced by one Referral: the Deals a Referral opened; when one is won, its revenue earns the Partner’s Commission. sourcedBy, inverse sources.

VerbsCopy Anchor Link

1. createCreates a Deal.
   POST /{namespace}/dealsdoDeal.created
2. getReturns one Deal by id.
   GET /{namespace}/deals/{id}readNo Event
3. listReturns Deals, newest first, one page at a time.
   GET /{namespace}/dealsreadNo Event
4. updateChanges the given properties of a Deal.
   PATCH /{namespace}/deals/{id}doDeal.updated
5. deleteDeletes a Deal; its history is kept.
   DELETE /{namespace}/deals/{id}doDeal.deleted
6. advanceAdvance moves a Deal to its next stage once every field that stage requires is filled.
   POST /{namespace}/deals/{deal}/advancedoDeal.advanced
7. assignAssign gives a Deal one owner Worker, who carries its next step until it is won or lost.
   POST /{namespace}/deals/{deal}/assigndoDeal.assigned
8. loseLose closes a Deal as lost and records the reason the buyer gave.
   POST /{namespace}/deals/{deal}/losedoDeal.lost
9. proposePropose sends a Deal’s buyer a Quote they accept to place an Order.
   POST /{namespace}/deals/{deal}/proposedoDeal.proposed
10. winWin closes a Deal as won, which places its Order and makes the buyer a Customer.
    POST /{namespace}/deals/{deal}/windoDeal.won

PermissionsCopy Anchor Link

Which Access level may call each Verb. One-way Verbs wait their delay window.

Call itCopy Anchor Link

Propose the latest deal with a quote.

ExampleCopy Anchor Link

A Deal with a county planning firm pursues the $900-a-month permit-records Offer plus a $3,000 backfill: value: 13,800 for year one. After two Meetings the firm accepts the Quote, and Quote.accept wins the Deal.