| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Atualiza o título de um card específico na plataforma Goalfy.
Este endpoint permite alterar o nome/título de um card já existente, utilizando o identificador único do card informado diretamente na rota da requisição.
É recomendado para integrações que precisam sincronizar informações externas com a Goalfy, corrigir títulos cadastrados, atualizar nomes de solicitações ou manter os cards alinhados com dados vindos de outros sistemas.
A atualização ocorre apenas no título do card, conforme o valor enviado no body da requisição.
Parâmetro utilizados
idCard
idCardIdentificador único do card que será atualizado.
Exemplo:
PUT https://api.goalfy.com.br/api/cards/1234512345 corresponde ao ID do card que terá o título atualizado.
Body da Requisição
O body deve ser enviado em formato JSON contendo o novo título do card.
Exemplo de body
{
"title": "[valor]"
}Campos do Body
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
title | string | Sim | Novo título que será atribuído ao card. |
Respostas esperadas
Sucesso 200Retorna a confirmação da atualização do card ou os dados atualizados, conforme o comportamento da API.
Após a execução bem-sucedida, o card informado passa a apresentar o novo título enviado no body da requisição.
Possíveis erros
400 Bad RequestRetornado quando o body da requisição possui formato inválido, quando o campo
titlenão foi enviado ou quando o valor informado é inconsistente.
404 Not FoundRetornado quando o card informado não existe ou não foi localizado.
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 atualizar o card informado.
Observações
ImportanteO campo
titledeve conter o novo título que será exibido no card.
- Apenas o título do card será atualizado por este endpoint.
- O ID do card deve ser válido e existir na plataforma.
- A atualização respeita as permissões do usuário autenticado.
- Recomenda-se validar o valor do título antes do envio da requisição.
- Caso o card esteja em um Board ou fase com regras específicas, a atualização pode depender das permissões configuradas.
FAQ?
Perguntas frequentes que fazem.
Segue abaixo cards que podem te ajudar a tirar essas dúvidas: