Skip to main content
DELETE
cURL
Este endpoint deleta permanentemente um alerta de gastos existente.

Descrição

O endpoint DELETE /tools/api/delete-spending-limit remove permanentemente um alerta de gastos do sistema. Esta ação não pode ser desfeita.

Autenticação

Este endpoint requer autenticação via Bearer token.
string
required
Bearer token com a API key do usuário. Formato: Bearer sk-your-api-key-here

Parâmetros de Query

string
required
Parâmetro interno para indicar requisições via MCP. Use s=s para requisições MCP.

Body Parameters

string
required
ID do alerta a ser deletado

Resposta

Sucesso (200)

Erro de Validação (400)

Erro de Autenticação (401)

Erro de Permissão (403)

Erro - Alerta Não Encontrado (404)

Campos da Resposta

boolean
required
Indica se a requisição foi bem-sucedida
string
required
Mensagem de confirmação da deleção
object
required
Objeto com informações básicas do alerta deletado
string
required
Timestamp da requisição em formato ISO 8601

Exemplos de Uso

cURL

JavaScript

Python

Códigos de Status

  • 200: Sucesso - Alerta deletado
  • 400: limitId inválido ou ausente
  • 401: Erro de autenticação
  • 403: Acesso negado - alerta pertence a outro usuário
  • 404: Alerta não encontrado
  • 500: Erro interno do servidor
Esta ação é irreversível! Uma vez deletado, o alerta não pode ser recuperado. Todos os dados relacionados ao histórico de alertas também serão removidos. Se você deseja apenas pausar temporariamente um alerta, considere usar o endpoint update-spending-limit com isActive: false ao invés de deletar.
Você só pode deletar alertas que pertencem ao seu usuário. Tentar deletar alertas de outros usuários resultará em erro 403 (Access denied).
Após deletar um alerta, o slot na quota do seu plano fica disponível imediatamente para criar um novo alerta.

Authorizations

Authorization
string
header
required

API key in Bearer token format. Example: Bearer sk-your-api-key-here

Body

application/json
limitId
string
required

ID do limite de gastos a ser excluído

Response

Limite de gastos excluído com sucesso

success
boolean
Example:

true

message
string
Example:

"Spending limit for \"Alimentação\" deleted successfully"

deletedLimit
object
timestamp
string<date-time>