| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Remove um registro específico de um Database utilizando seu identificador único (id).
Este endpoint permite excluir registros existentes na plataforma de forma permanente, sendo recomendado para integrações que necessitam realizar limpezas de dados, remoção de cadastros ou gerenciamento automatizado de registros.
A exclusão será aplicada diretamente ao registro informado na rota da requisição.
Importante
AtençãoAntes de realizar a exclusão, certifique-se de que o registro informado é realmente o desejado, pois essa operação pode impactar processos, automações e relacionamentos vinculados ao Database.
Parâmetros Utilizados
id
idIdentificador único do registro que será removido.
O ID deve ser informado diretamente na rota da requisição.
Exemplo:
DELETE https://api.goalfy.com.br/api/forms/12345Neste exemplo:
12345
Corresponde ao ID do registro que será excluído.
Exemplo de Resposta
{
"success":true,
"message":"Registro excluído com sucesso."
}
Possíveis erros
404 Not FoundRetornado quando o registro 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 excluir o registro informado.
Observações
ImportanteA exclusão de registros pode impactar integrações, automações e relacionamentos existentes na plataforma.
- O id deve corresponder a um registro válido existente no Database.
- Dependendo das regras da organização, apenas usuários autorizados poderão realizar exclusões.
- Recomenda-se validar o registro antes de executar a remoção.
- Registros vinculados a outros processos podem afetar consultas e automações após a exclusão.
- 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:
200