Atualiza um card de um Kanban

put

https://api.chatfunnel.com.br/v1/kanbans/{kanbanId}/cards/{cardIdOrContactId}

Permissão necessária na apikey: MANAGE_KANBAN. Localiza o card por cardId ou por contactId (via parâmetro cardIdOrContactId). Permite mover de coluna, atualizar prioridade, status da oportunidade, motivo/perda, amount, adicionar comentário e gerenciar moderadores (add/remove).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

kanbanId

uuid

required

ID do Kanban.

cardIdOrContactId

uuid

required

ID do card ou ID do contato vinculado ao card.

Query Params

apikey

string

required

chave de autenticação.

Body Params

columnId

uuid

Nova coluna de destino (opcional). Se informado, o card é movido.

comment

string

Comentário a ser adicionado ao histórico do card.

priority

string

enum

Prioridade do card.

Allowed:

statusOportunity

string

enum

Status da oportunidade do card.

Allowed:

amount

integer

Valor associado à oportunidade. Deve ser inteiro.

lossReasonId

uuid

Motivo de perda (obrigatório quando statusOportunity=LOST, caso não informado será criado "lost - API").

lossReasonMessage

string

Mensagem complementar do motivo de perda.

moderatorId

uuid

ID do usuário a adicionar como moderador. Tem prioridade sobre addModerators/removeModerators.

addModerators

array of uuids

deprecated

Deprecated — use moderatorId. IDs de usuários a adicionar como moderadores (apenas o primeiro item é considerado).

addModerators

removeModerators

array of uuids

deprecated

Deprecated — use moderatorId. IDs de usuários a remover da moderação (apenas o primeiro item é considerado).

removeModerators

Responses

200Card atualizado com sucesso.

401Não autorizado (apikey ausente, inválida ou expirada).

403Proibido — apikey sem a permissão MANAGE_KANBAN.

404Recurso não encontrado.

422Erro de validação (params/body).

500Erro interno do servidor.