> ## 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. # Listar próximas ocurrencias programadas > Utiliza este endpoint para calcular las próximas ocurrencias del trigger de programación de un workflow, evaluadas en la zona horaria de la programación. Un workflow sin trigger de programación devuelve 422. ## OpenAPI ````yaml es/openapi/v3-current/flowker.yaml get /v1/workflows/{id}/schedule/upcoming 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 executor, configuraciones de provider y ejecuciones de workflows. title: API de Flowker version: 1.2.0 servers: - url: https://flowker.sandbox.lerian.net security: - BearerAuth: [] tags: - name: Catalog API description: >- Explora los providers, executors y triggers integrados disponibles en el catálogo de Flowker. - name: Workflows API description: >- Crea, actualiza, activa, desactiva, clona y elimina definiciones de workflows. - name: Executions API description: Inicia ejecuciones de workflows y rastrea su estado y sus resultados. - name: Executor Configurations API description: >- Lista, consulta, actualiza y elimina los registros de configuración de executor que mantiene un despliegue. - name: Provider Configurations API description: >- Crea, actualiza, habilita y deshabilita las configuraciones de provider por las que llaman los nodes de workflow. - name: Dashboard API description: >- Recupera resúmenes agregados de workflows y ejecuciones para dashboards operacionales. - name: Webhooks API description: >- Recibe callbacks de webhooks desde sistemas externos para disparar ejecuciones de workflows. - name: Schedule API description: >- Inspecciona las ocurrencias programadas próximas, omitidas y retenidas de un workflow, y ejecuta o descarta las retenidas. - name: Schema Registry API description: >- Publica versiones globales de especificación OpenAPI para servicios nativos y fija la versión que resuelve cada tenant. - name: OpenAPI Schemas API description: >- Sube, consulta y elimina los esquemas OpenAPI externos del tenant, y deriva el contrato de una operación concreta. - name: XSD Schemas API description: >- Sube, consulta y elimina los esquemas XSD del tenant que validan las cargas XML de los webhooks. paths: /v1/workflows/{id}/schedule/upcoming: get: tags: - Schedule API summary: Listar próximas ocurrencias programadas description: >- Utiliza este endpoint para calcular las próximas ocurrencias del trigger de programación de un workflow, evaluadas en la zona horaria de la programación. Un workflow sin trigger de programación devuelve 422. operationId: listWorkflowScheduleUpcoming parameters: - description: Identificador del workflow (UUID). in: path name: id required: true schema: description: Identificador del workflow (UUID). type: string example: 018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8 - description: Número de ocurrencias a calcular (1-50; por defecto 10). explode: false in: query name: limit schema: description: Número de ocurrencias a calcular (1-50; por defecto 10). type: string example: '10' responses: '200': content: application/json: schema: $ref: '#/components/schemas/UpcomingOccurrencesOutput' description: >- Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados. default: content: application/problem+json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que la solicitud falló. El cuerpo es un documento de problema RFC 9457. components: schemas: UpcomingOccurrencesOutput: additionalProperties: false properties: occurrences: items: $ref: '#/components/schemas/UpcomingOccurrenceOutput' type: - array - 'null' required: - occurrences type: object ErrorResponse: properties: code: description: Código de error de Flowker, estable y legible por máquina. example: FLK-0001 type: string detail: description: >- Explicación legible de esta ocurrencia. Las respuestas con estado 500 o superior llevan un mensaje genérico fijo. example: name is a required field type: string errors: description: Entradas por campo para una solicitud que no pasó la validación. items: $ref: '#/components/schemas/ErrorDetail' type: array instance: description: Referencia URI que identifica esta ocurrencia específica. example: /v1/workflows format: uri type: string status: description: Código de estado HTTP. example: 400 type: integer title: description: >- Frase de estado HTTP estándar del status. No cambia según el código de error. example: Bad Request type: string type: description: >- Referencia URI que identifica el error. Siempre es la base del catálogo de errores seguida del código. example: https://errors.lerian.studio/v1/FLK-0001 format: uri type: string type: object UpcomingOccurrenceOutput: additionalProperties: false properties: scheduledFor: format: date-time type: string example: '2026-01-15T10:30:00Z' required: - scheduledFor type: object ErrorDetail: properties: location: description: Dónde está el problema, como body.nodes o path.id. example: body.nodes type: string message: description: Descripción del problema a nivel de campo. example: expected array length >= 1 type: string value: description: El valor que causó el error, cuando es seguro incluirlo. type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Token bearer JWT emitido por el provider de identidad. Envíalo en la cabecera Authorization como `Bearer `. ````