Deletar registro em Especifico

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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ção

Antes 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

Identificador ú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/12345

Neste exemplo:

12345

Corresponde ao ID do registro que será excluído.


Exemplo de Resposta

{
   "success":true,
   "message":"Registro excluído com sucesso."
}

✅

Resposta esperadas

Sucesso 200

Remove o registro informado com sucesso.


❗

Possíveis erros

404 Not Found

Retornado quando o registro informado não existe ou não foi localizado.

401 Unauthorized

Retornado quando o token de autenticação é inválido ou não foi enviado corretamente.

403 Forbidden

Retornado quando o usuário não possui permissão para excluir o registro informado.


Observações

🚧

Importante

A 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:

Path Params
string
required
Headers
string
Defaults to "Token YOUR_TOKEN"
Response
200
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!