Skip to main content

​
Endpoint

PATCH /v1/deals/:id
Escopo necessário: write:deals Envie apenas os campos que deseja alterar.

​
Corpo da requisição

CampoTipoDescrição
titlestringTítulo
descriptionstring|nullDescrição
valuenumberValor em reais
assigned_tostring|nullID do responsável
expected_close_datestring|nullData prevista de fechamento
probabilityintegerProbabilidade 0–100
tagsstring[]Substitui completamente as tags
custom_fieldsobjectSubstitui completamente os campos personalizados
Para mover o negócio para outra etapa, use POST /v1/deals/:id/move. Para marcar como ganho ou perdido, use os endpoints dedicados.

​
Exemplo de requisição

curl -X PATCH https://api.socialsell.ai/v1/deals/664c1d2e3f4a5b6789012347 \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "value": 22000,
    "probability": 85,
    "expected_close_date": "2026-07-15T00:00:00.000Z"
  }'

​
Resposta

Retorna o objeto negócio atualizado.