> ## Documentation Index
> Fetch the complete documentation index at: https://developer.omni.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Remover webhook padrão

> Remova um webhook padrão do workspace

## Conceituação

Remove um webhook padrão. Depois da remoção, o Omni Z-API para de enviar eventos para a URL configurada, e a vaga no limite de 5 do workspace fica livre.

Se era o único webhook padrão que assinava um evento, os canais sem webhook próprio deixam de entregar esse evento.

> [!WARNING]
>
> A remoção é permanente. Para pausar o webhook, use [Atualizar webhook padrão](/webhooks/update-default-webhook.md) com `status: "DISABLED"`.

> [!NOTE]
>
> O `webhookId` é obtido no retorno do endpoint [Criar webhook padrão](/webhooks/create-default-webhook.md) ou [Listar webhooks padrão](/webhooks/list-default-webhooks.md).


## OpenAPI

````yaml pt/webhooks/openapi-default.json DELETE /v1/default-instance-webhooks/{webhookId}
openapi: 3.1.0
info:
  title: Omni Z-API - Webhook padrão do workspace
  description: >-
    API para criar e gerenciar o webhook padrão do workspace: um webhook sem
    canal que recebe os eventos de todo canal do workspace que não tem webhook
    próprio ativo. Aceita os eventos de canal, nos formatos `DEFAULT` e `Z_API`,
    com até 5 por workspace. Não exige a role ENTERPRISE: basta uma secret key
    válida de um workspace ativo.
  version: 1.0.0
servers:
  - url: https://api.omni.z-api.io
security:
  - bearerAuth: []
paths:
  /v1/default-instance-webhooks/{webhookId}:
    parameters:
      - name: webhookId
        in: path
        required: true
        description: ID do webhook padrão
        schema:
          type: string
          example: 5B7E3A90C2D14F6A8E1B2C3D4E5F6A7B
    delete:
      tags:
        - Webhook padrão
      summary: Remover webhook padrão
      description: >-
        Remove um webhook padrão. Ele deixa de receber eventos e deixa de contar
        no limite de 5 do workspace.
      operationId: deleteDefaultInstanceWebhook
      responses:
        '204':
          description: Webhook padrão removido
        '400':
          description: Secret key ausente ou inválida, ou IP fora da lista do workspace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                invalidKey:
                  summary: Secret key ausente ou inválida
                  value:
                    error: Authorization invalid
                ipNotAllowed:
                  summary: IP fora da lista de IPs permitidos do workspace
                  value:
                    error: 203.0.113.10 not allowed
        '404':
          description: >-
            Não há webhook padrão com esse id no workspace. Um id de outro
            workspace, de um webhook de canal ou de um webhook de template
            recebe a mesma resposta.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Webhook not found
        '422':
          description: Workspace excluído ou inexistente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Webhook management requires an active workspace
components:
  schemas:
    Error:
      type: object
      description: Erro
      properties:
        error:
          type: string
          description: Mensagem do erro
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Secret Key gerada no painel de Segurança do Omni Z-API

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.