> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Disparar um webhook (DELETE) > Recebe um callback de webhook via HTTP DELETE e dispara a execução do workflow associado. O caminho é resolvido dinamicamente contra o registro de webhooks; cada workflow pode registrar seu próprio caminho de webhook. Em tempo de execução são aceitos os métodos GET, POST, PUT, PATCH e DELETE nesta rota, bem como caminhos aninhados com múltiplos segmentos. ## OpenAPI ````yaml pt/openapi/v3-current/flowker.yaml delete /v1/webhooks/{path} openapi: 3.1.0 info: description: >- Referência completa da API para os serviços de orquestração de workflows do Flowker, incluindo gerenciamento de catálogo, definições de workflows, configurações de executores, configurações de provedores e execuções de workflows. title: API do Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore provedores, executores e gatilhos integrados disponíveis no catálogo do Flowker. - name: Workflows API description: Crie, atualize, ative, desative, clone e exclua definições de workflows. - name: Executions API description: Inicie execuções de workflows e acompanhe seu status e resultados. - name: Executor Configurations API description: >- Configure, teste e gerencie conexões de executores externos utilizadas pelos nós de workflow. - name: Provider Configurations API description: Configure, teste, habilite e desabilite integrações de provedores. - name: Dashboard API description: >- Recupere resumos agregados de workflows e execuções para dashboards operacionais. - name: Audit API description: >- Consulte e verifique eventos de auditoria para conformidade e visibilidade operacional. - name: Webhooks API description: >- Receba callbacks de webhooks de sistemas externos para disparar execuções de workflows. paths: /v1/webhooks/{path}: delete: tags: - Webhooks API summary: Disparar um webhook (DELETE) description: >- Recebe um callback de webhook via HTTP DELETE e dispara a execução do workflow associado. O caminho é resolvido dinamicamente contra o registro de webhooks; cada workflow pode registrar seu próprio caminho de webhook. Em tempo de execução são aceitos os métodos GET, POST, PUT, PATCH e DELETE nesta rota, bem como caminhos aninhados com múltiplos segmentos. operationId: triggerWebhookDelete parameters: - description: >- Caminho do webhook registrado por um workflow. Suporta caminhos aninhados com múltiplos segmentos em tempo de execução. Barras dentro do caminho devem ser codificadas como `%2F` conforme RFC 3986/OpenAPI 3.1 (por exemplo, use `orders%2Fpaid` para `orders/paid`). in: path name: path required: true schema: type: string - description: >- Chave de idempotência opcional para evitar execuções duplicadas a partir da mesma entrega de webhook. in: header name: Idempotency-Key schema: type: string - description: >- Token de verificação por webhook. Validado pelo handler quando configurado na rota do webhook. in: header name: X-Webhook-Token schema: type: string requestBody: content: application/json: schema: type: object additionalProperties: true description: >- Payload do webhook proveniente do sistema externo. O Flowker injeta metadados do webhook (chave `_webhook` com método, caminho, headers, parâmetros de query e IP remoto) antes de passá-lo ao workflow. description: Payload do webhook. Tamanho máximo de 1 MB. required: false responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExecutionCreateOutput' description: Execução do workflow concluída de forma síncrona (estado terminal). '201': content: application/json: schema: $ref: '#/components/schemas/ExecutionCreateOutput' description: Execução do workflow criada e em execução de forma assíncrona. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que o corpo da solicitação está malformado ou não pôde ser processado. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Não autorizado. A API key é inválida ou o header `X-Webhook-Token` está ausente ou incorreto. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Não há webhook registrado para este caminho e método HTTP, ou o workflow associado não foi encontrado. '409': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Chave de idempotência duplicada; esta entrega de webhook já foi processada. '413': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: O payload do webhook excede o limite de tamanho de 1 MB. '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- O workflow associado não está em estado ativo e não pode ser executado. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica um erro interno inesperado. Se persistir, entre em contato com o suporte. components: schemas: ExecutionCreateOutput: properties: executionId: description: Identificador único da execução. example: f7e6d5c4-b3a2-1098-7654-321fedcba098 format: uuid type: string startedAt: description: Marca temporal de quando a execução foi iniciada. example: '2026-03-17T14:35:00Z' format: date-time type: string status: description: Status inicial da execução (sempre `pending`). example: running type: string workflowId: description: ID do workflow sendo executado. example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 format: uuid type: string type: object ErrorResponse: properties: code: description: Código de erro legível por máquina com o prefixo FLK. example: FLK-0001 type: string message: description: Explicação do erro legível por humanos. example: Invalid input provided type: string title: description: Título curto da categoria de erro. example: Bad Request type: string required: - code - message - title type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Chave de API para autenticar as requisições à API do Flowker. Provisionada por meio da variável de ambiente API_KEY durante o deployment. ````