Pular para o conteúdo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Remover Cadastro de Webhook

Remove definitivamente o cadastro de webhook do originator autenticado via JWT. Após a remoção, a plataforma deixa de entregar eventos para este originator.

Para o ciclo de vida da entrega, eventos disponíveis e validação de assinatura, veja Configuração via API, Eventos, Payloads e Segurança e exemplos.

Request

DELETE /api/v1/webhooks

Autenticado: Authorization: Bearer {originatorToken}.

Response

  • 204 No Content — cadastro de webhook removido com sucesso. Corpo vazio.

Exemplo

DELETE /api/v1/webhooks HTTP/1.1
Host: ingress.gtfgts.staging.giro.tech
Authorization: Bearer {originatorToken}
HTTP/1.1 204 No Content

Erros

Código
Situação

401

Token ausente, inválido ou expirado — errorCode = UNAUTHORIZED

404

O originator autenticado não possui cadastro de webhook — errorCode = WEBHOOK_SUBSCRIPTION_NOT_FOUND

500

Erro interno inesperado — errorCode = INTERNAL_ERROR

503

Indisponibilidade momentânea — errorCode = SUBMISSION_TEMPORARILY_UNAVAILABLE (header Retry-After: 5)

Os erros seguem o formato ProblemDetail (RFC 7807), com o campo errorCode. Ver Erros da API.

Remove o cadastro de webhook do originator autenticado

delete
/api/v1/webhooks

Remove definitivamente o cadastro de webhook do originator autenticado. Após remoção, nenhum evento será entregue para este originator. 404 se o originator não possui cadastro de webhook.

Autorizações
AuthorizationstringObrigatório

JWT de originator fornecido pela GTLab no cadastro do originator. Identifica e autoriza o originator em todos os endpoints /api/v1/**. Inclua no header: Authorization: Bearer <token>.

Respostas
204

Cadastro de webhook removido com sucesso. Corpo vazio.

Sem conteúdo

delete/api/v1/webhooks
DELETE /api/v1/webhooks HTTP/1.1
Host: ingress.gtfgts.staging.giro.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

Sem conteúdo

Atualizado