> For the complete documentation index, see [llms.txt](https://docs.cange.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cange.me/api/fluxos/mover-um-cartao.md).

# 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.

{% content-ref url="/pages/9WZ3PW4K1WSS8OpsOrjm" %}
[Autenticação](/api/autenticacao.md)
{% endcontent-ref %}

**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:

<figure><img src="/files/8mFBgWfMMsJHcaOTqUde" alt=""><figcaption></figcaption></figure>

`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:

<figure><img src="/files/Q02CQOXLprBiHaKGANfX" alt=""><figcaption></figcaption></figure>

`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:&#x20;

<figure><img src="/files/8MjSBy7CAZCm9y36CqdW" alt=""><figcaption></figcaption></figure>

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

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

<mark style="color:green;">`POST`</mark> `/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                      | <p>Código identificador do <br>fluxo</p>                                                |
| `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"
}
```

**Response**

{% tabs %}
{% tab title="200" %}

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

{% endtab %}
{% endtabs %}