Move deal
Moves a deal to another phase of its pipeline.
POST https://cotlet.dev/api/v1/teamleader/phases/{phase_id}/deals/{deal_id}/move
write
Moves one deal to the phase you name. A deal does not have to pass every phase. If that phase has a follow-up action, Teamleader plans the task, meeting or call as it does when you drag the deal in the app. Moving back undoes it, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| deal_id string required | string | Deal ID from list_deals. |
| phase_id string required | string | Target phase ID from list_deal_phases. |
Request
curl -X POST https://cotlet.dev/api/v1/teamleader/phases/phase_8c41d2/deals/deal_8c41d2/move \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("teamleader", "move_deal", {"deal_id":"deal_8c41d2","phase_id":"phase_8c41d2"})const result = await cotlet.call('teamleader', 'move_deal', {"deal_id":"deal_8c41d2","phase_id":"phase_8c41d2"});cotlet call teamleader move_deal --data '{"deal_id":"deal_8c41d2","phase_id":"phase_8c41d2"}'Example response
{
"deal_id": "9c1f3a5e-7b24-4d68-8e0a-5f2b4c6d8e10",
"phase": "Accepted",
"moved_at": "2026-10-20T08:05:00Z"
}