Editar os campos de um cartão

Os cartões são componentes vitais na gestão de tarefas, projetos e fluxos de trabalho dentro da plataforma Cange, permitindo uma visualização clara e organizada de todas as atividades e responsabilidades.

Usar a API do Cange para editar as respostas dos cartões oferece uma maneira eficiente e automatizada de editar essas unidades de trabalho diretamente a partir das suas aplicações ou sistemas existentes, aumentando a produtividade e integridade dos processos.

Para editar as respostas de um cartão através da API, você precisará ter um token de acesso. Se ainda não possui o seu token, consulte nosso guia abaixo sobre como obter o token de autenticação.

Veja também: Autenticação

Com esta requisição será possível apenas editar campos dinâmicos do cartão e será editado apenas campos do mesmo formulário. Para a edição de campos de formulários diferentes é necessário fazer uma requisição por formulário.

Como os fluxos no Cange possuem campos dinâmicos, simplificamos o processo para você. Na tela de configuração do formulário, oferecemos uma opção prática para copiar o objeto do body da requisição. Basta abrir a tela de edição do formulário inicial ou de alguma etapa e abaixo da pré-visualização do formulário, você encontrará um contêiner com a informação "Objeto API". Copie esse objeto e use-o como base para montar sua solicitação de edição de um cartão, garantindo que todos os campos dinâmicos sejam corretamente incluídos.

Lembrete: Todos os campos possuem validação, portanto é necessário que seja enviado no formato correto para que sua requisição seja concluída com sucesso.

Realizando a chamada para edição do cartão

https://api.cange.me/form/answer

PUT /form/answer

Endpoint com o objetivo de editar os dados de um cartão dentro de um fluxo

Headers

Body

{
  "id_form": 36197,
  "flow_id": 5369,
  "card_id": 83454,
  "values": {
    "8156f3254601ca4eb9e05786ab4066d3328bb4e4": "999"
  }
}

Resposta (200)

{
    "form_answer_id": 381718,
    "field_id": 92325,
    "index": 0,
    "value": "777",
    "dt_created": "2024-10-09T19:12:46.000Z",
    "dt_last_update": "2024-10-09T19:12:46.000Z",
    "id_form_answer_field": 2415458,
    "dt_deleted": null
}