Endpoint Mover Candidato entre Etapas [PUT]

Endpoint

[PUT] https://api.quickin.io/accounts/{account_id}/placements/{placement_id}/move

Autenticação (Header)

Authorization: Bearer {token}

Campos

Campo	Tipo	Exemplo	Descrição	Limites
account_id	String	`5cc06fb40843440011f80765`	ID da conta Quickin
placement_id	String	`69e101ac6f6d5600131ae312`	ID do item do array `placements` retornado ao consultar o candidato
stage_id	String	`69738746bf10bb00133b6fdd`	ID do estágio/etapa para onde o candidato será movido	Ver lista de estágios

Exemplo de requisição

PUT https://api.quickin.io/accounts/{account_id}/placements/{placement_id}/move

{
  "stage_id": "{stage_id}"
}

Funcionamento

Para mover um candidato de estágio, é necessário utilizar o placement_id de um item do array placements.

Esse array é retornado ao consultar os dados do candidato. Cada item dentro de placements representa uma participação/vínculo do candidato em uma vaga ou processo seletivo.

Dependências

Lista de estágios disponíveis

[GET] https://api.quickin.io/accounts/{account_id}/stages

GET https://api.quickin.io/accounts/{account_id}/stages

[
    {
        "_id": "69738746bf10bb00133b6fdd",
        "name": "Triagem"
    },
    {
        "_id": "69738746bf10bb00133b6fdd",
        "name": "Entrevista"
    },
    {
        "_id": "69738746bf10bb00133b6fdd",
        "name": "Contratação"
    }
]

Observações

Para mover o candidato:

Consulte o candidato.
Localize o item correto dentro do array placements.
Copie o id desse item.
Consulte a lista de estágios disponíveis.
Copie o id do estágio desejado.
Envie a requisição [PUT] /placements/{placement_id}/move informando o stage_id.

O stage_id define para qual estágio o candidato será movido.