POST /v1/deals/{id}/move
const url = 'https://seu-endereco-da-api/v1/deals/example/move';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"stageId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","assigneeId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://seu-endereco-da-api/v1/deals/example/move \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "stageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "assigneeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'Permissão que a Chave de acesso precisa: Criar e mover negócios (deals:manage).
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Path Parameters
Seção intitulada “Path Parameters”Request Bodyrequired
Seção intitulada “Request Bodyrequired”object
Example generated
{ "stageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "assigneeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Responses
Seção intitulada “Responses”object
Sequential per tenant, shown as #número
Data prevista de fechamento
Valores dos campos personalizados do negocio (entity deal), pela chave do campo
object
object
object
When the deal arrived as a new lead through the intake
object
Presigned url for the contact’s whatsapp profile photo
object
object
Public url for the user’s photo
object
Public url for the user’s photo
object
Unit price in centavos
Fields the target stage marks as important that are still empty; the deal entered anyway
object
Example
{ "status": "open", "importantFieldsMissing": [ { "entity": "contact" } ]}Stage of another pipeline, or unknown assignee id
The target stage refuses the deal: assignee_required (the stage requires an assignee and the deal has none; send assigneeId to assign one in the same move), required_tasks_pending, required_fields_missing (fields carry their entity: contact, company or deal; requirements lists expected_close_date, value, products, and company when a company field is required and the deal has none) or required_attachment_missing