Deals

Move a deal to a new stage

Stamps wonAt/deadAt/commitmentAt automatically as appropriate (keyed off the target stage's region). Fires deal.stage_changed (and deal.won when applicable) on subscribed webhooks.

post/v1/deals/{id}/move

Request

  • Base URL: https://app.getdealboard.com
  • URL: https://app.getdealboard.com/v1/deals/{id}/move
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional client-chosen string. If the same key is sent twice within 24h with the same body, the original response is replayed.

Request body

toStageIdstring required

Stage id from the deal's board.

Response

OK

idstring uuid required
boardIdstring uuid required
namestring required
companystring nullable required
amountCentsinteger nullable required

Deal value in minor currency units (cents). No floats.

currency'USD' | 'EUR' | 'GBP' | 'CAD' | 'AUD' | 'JPY' | 'INR' required
ownerIdstring uuid required
ownerNamestring nullable required
labelsstring[] required
keyTermsstring nullable required
createdAtstring date-time required
updatedAtstring date-time required
stageEnteredAtstring date-time required
commitmentAtstring date-time nullable required
wonAtstring date-time nullable required
deadAtstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.