/v1/definitions/{key}/rows/{rowId}/transitionMove a deal's status
Move one deal to another status. The STAGE is derived from that status's band and written, never taken from the caller; the stage-entry gate is checked on a crossing and may be skipped with force. Send cells to fill what the gate needs in the same transaction, and reason to say why - a terminal status asks for one. For a deal that is actually over, use the close route instead: it records the outcome, the reason and the follow-up task with the move.
Access class: def:read.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"archived_at": "string",
"assignees": {},
"cells": {},
"createdBy": "string",
"display": {},
"externalId": "",
"groupId": "",
"id": "",
"position": 1,
"source": "string"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}