Mover 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 mover cartões oferece uma maneira eficiente e automatizada de mover entre etapas essas unidades de trabalho diretamente a partir das suas aplicações ou sistemas existentes, aumentando a produtividade e integridade dos processos.

Para mover 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 mover os cartões entre as etapas do seu fluxo. Para ter acesso aos identificadores de cada objeto, siga os passos abaixo:

flow_id

Entre no Fluxo que deseja integrar e clique no ícone ? ao lado do nome do fluxo para abrir o menu suspenso, nele você poderá visualizar o identificador:

id_card

Abra o cartão e clique no ícone "..." no canto superior direito para abrir o menu suspenso do cartão, nele você poderá visualizar o identificador:

to_step_id

Visualize o Kanban do seu fluxo e na etapa que desejar mover o seu cartão, clique no ícone "..." para abair o menu suspenso, nele você poderá visualizar o identificador:

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

https://api.cange.me/card/move-step

POST /card/move-step

Endpoint com o objetivo de mover um cartão entre as etapas de um fluxo

Headers

Name	Value
Content-Type	`application/json`
Origin	`https://app.cange.me`
Authorization	`Bearer <token de acesso>`

Body

Name	Type	Description
`flow_id`	number	Código identificador do fluxo
`id_card`	number	Código identificador do cartão
`to_step_id`	number	Código identificador da etapa que deseja mover o cartão
`complete`	string (S = Sim ou N = Não)	Parâmetro opcional para definir se o cartão deve ser finalizado após a movimentação

{
    "flow_id": 5369,
    "id_card": 83456,
    "to_step_id": 28792,
    "complete": "S"
}

Resposta (200)

{
    "id_card": 83456,
    "dt_due": "2024-10-11",
    "flow_step_id": 28792,
    "user_id": 76
}