# 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="../autenticacao" %}
[autenticacao](https://docs.cange.me/api/autenticacao)
{% 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="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FG0v8ncSlNKzm7mPdiIjl%2FScreenshot%202024-10-09%20at%2018.49.11.png?alt=media&#x26;token=ed44b12e-6cdc-4142-96bf-07b7b368312a" 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="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FBtd6cRDHoKfhPDpAZQXE%2FScreenshot%202024-10-09%20at%2018.50.27.png?alt=media&#x26;token=4a33f3ac-1a74-4192-ab15-a21eda5915bf" 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="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FSmiLj6YthAOAlHCwpXHE%2FScreenshot%202024-10-09%20at%2018.49.43.png?alt=media&#x26;token=6f507be8-825f-4caf-b11e-ee63cc736cf2" 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 %}