| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Move um card específico para outra fase dentro do fluxo de um Board.
Este endpoint permite alterar a fase atual de um card utilizando seu identificador único (id) e informando a fase de destino através do parâmetro phaseId.
É recomendado para integrações que necessitam automatizar movimentações de cards, atualizar o andamento de processos ou sincronizar etapas entre sistemas externos e a plataforma.
Após a execução da requisição, o card passará a pertencer à fase informada no payload.
Parâmetros utilizados
id do Card
id do CardIdentificador único do card que será movimentado.
O ID deve ser informado diretamente na rota da requisição.
Exemplo:
PUT https://api.goalfy.com.br/api/cards/moveTo/12345Neste exemplo:
12345
Corresponde ao ID do card que será movido.
Body da requisição
O payload deve informar a fase de destino através do campo phaseId.
Campos utilizados:
| Campo | Tipo | Descrição |
|---|---|---|
phaseId | String | Identificador da fase para onde o card será movido. |
Exemplo de body
{
"phaseId": "123456" //id da Fase de Destino
}Exemplo de Resposta
{
"createdAt": "2026-05-22T00:00",
"dateInCurrentPhase": "2026-06-08T00:00",
"formId": "12345",
"id": "12345",
"index": 10.0,
"phaseId": "12345",
"responsibles": [
{
...
}
],
"subtitleFields": [],
"tags": [],
"title": "Rascunho",
"updatedAt": "2026-06-08T00:00"
}
Possíveis erros
400 Bad RequestRetornado quando o phaseId não foi informado ou possui um formato inválido.
404 Not FoundRetornado quando o card ou a fase informada não existem ou não foram localizados.
401 UnauthorizedRetornado quando o token de autenticação é inválido ou não foi enviado corretamente.
403 ForbiddenRetornado quando o usuário não possui permissão para movimentar o card ou acessar a fase informada.
Observações
ImportanteO card será movido imediatamente para a fase informada após a execução da requisição.
- O phaseId deve corresponder a uma fase válida e acessível pelo usuário autenticado.
- Dependendo das regras configuradas no Board, determinadas movimentações podem possuir validações adicionais.
- Recomenda-se validar previamente a existência da fase de destino antes de realizar a movimentação.
- A movimentação poderá gerar eventos e registros no histórico (logs) do Board.
- O retorno da requisição pode variar conforme as permissões do usuário autenticado.
FAQ?
Perguntas frequentes que fazem.
Segue abaixo cards que podem te ajudar a tirar essas dúvidas: