> ## 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 un webhook (GET) > Recibe un callback de webhook vía HTTP GET y dispara la ejecución del workflow asociado. La ruta se resuelve dinámicamente contra el registro de webhooks; cada workflow puede registrar su propia ruta de webhook. En tiempo de ejecución se aceptan los métodos GET, POST, PUT, PATCH y DELETE en esta ruta, así como rutas anidadas con múltiples segmentos. ## OpenAPI ````yaml es/openapi/v3-current/flowker.yaml get /v1/webhooks/{path} openapi: 3.1.0 info: description: >- Referencia completa de la API para los servicios de orquestación de workflows de Flowker, incluyendo gestión de catálogo, definiciones de workflows, configuraciones de ejecutores, configuraciones de proveedores y ejecuciones de workflows. title: API de Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore proveedores, ejecutores y disparadores integrados disponibles en el catálogo de Flowker. - name: Workflows API description: >- Cree, actualice, active, desactive, clone y elimine definiciones de workflows. - name: Executions API description: Inicie ejecuciones de workflows y rastree su estado y resultados. - name: Executor Configurations API description: >- Configure, pruebe y administre conexiones de ejecutores externos utilizadas por los nodos de workflow. - name: Provider Configurations API description: Configure, pruebe, habilite y deshabilite integraciones de proveedores. - name: Dashboard API description: >- Recupere resúmenes agregados de workflows y ejecuciones para dashboards operacionales. - name: Audit API description: >- Consulte y verifique eventos de auditoría para cumplimiento y visibilidad operacional. - name: Webhooks API description: >- Reciba callbacks de webhooks desde sistemas externos para disparar ejecuciones de workflows. paths: /v1/webhooks/{path}: get: tags: - Webhooks API summary: Disparar un webhook (GET) description: >- Recibe un callback de webhook vía HTTP GET y dispara la ejecución del workflow asociado. La ruta se resuelve dinámicamente contra el registro de webhooks; cada workflow puede registrar su propia ruta de webhook. En tiempo de ejecución se aceptan los métodos GET, POST, PUT, PATCH y DELETE en esta ruta, así como rutas anidadas con múltiples segmentos. operationId: triggerWebhookGet parameters: - description: >- Ruta de webhook registrada por un workflow. Soporta rutas anidadas con múltiples segmentos en tiempo de ejecución. Las barras diagonales dentro de la ruta deben codificarse como `%2F` según RFC 3986/OpenAPI 3.1 (por ejemplo, use `orders%2Fpaid` para `orders/paid`). in: path name: path required: true schema: type: string - description: >- Clave de idempotencia opcional para evitar ejecuciones duplicadas a partir de la misma entrega de webhook. in: header name: Idempotency-Key schema: type: string - description: >- Token de verificación por webhook. Validado por el handler cuando está configurado en la ruta del webhook. in: header name: X-Webhook-Token schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExecutionCreateOutput' description: >- Ejecución del workflow completada de forma síncrona (estado terminal). '201': content: application/json: schema: $ref: '#/components/schemas/ExecutionCreateOutput' description: Ejecución del workflow creada y ejecutándose de forma asíncrona. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Indica que la solicitud está mal formada o no pudo ser procesada. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- No autorizado. La API key no es válida o el header `X-Webhook-Token` está ausente o es incorrecto. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- No hay ningún webhook registrado para esta ruta y método HTTP, o el workflow asociado no fue encontrado. '409': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Clave de idempotencia duplicada; esta entrega de webhook ya fue procesada. '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- El workflow asociado no está en estado activo y no puede ser ejecutado. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica un error interno inesperado. Si persiste, contacte al soporte. components: schemas: ExecutionCreateOutput: properties: executionId: description: Identificador único de la ejecución. example: f7e6d5c4-b3a2-1098-7654-321fedcba098 format: uuid type: string startedAt: description: Marca de tiempo de cuando se inició la ejecución. example: '2026-03-17T14:35:00Z' format: date-time type: string status: description: Estado inicial de la ejecución (siempre `pending`). example: running type: string workflowId: description: ID del workflow que se está ejecutando. example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 format: uuid type: string type: object ErrorResponse: properties: code: description: Código de error legible por máquina con el prefijo FLK. example: FLK-0001 type: string message: description: Explicación del error legible por humanos. example: Invalid input provided type: string title: description: Título corto de categoría de error. example: Bad Request type: string required: - code - message - title type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Clave de API para autenticar las solicitudes a la API de Flowker. Se aprovisiona mediante la variable de entorno API_KEY durante el despliegue. ````