List Upcoming Scheduled Occurrences

Use this endpoint to list the next occurrences across the workflow’s enabled schedule triggers, merged by time and tagged with the trigger that fires each, in each schedule’s timezone. It answers 422 when the workflow has no schedule trigger, and an empty list when every one is disabled.

GET /v1/workflows/{id}/schedule/upcoming

List Upcoming Scheduled Occurrences

cURL

curl --request GET \
  --url https://flowker.sandbox.lerian.net/v1/workflows/{id}/schedule/upcoming \
  --header 'Authorization: Bearer <token>'

200

{
  "occurrences": [
    {
      "scheduledFor": "2026-01-15T10:30:00Z",
      "triggerNodeId": "trigger-1"
    }
  ]
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider. Send it in the Authorization header as Bearer <token>.

Parámetros de ruta

id · string · requerido

Workflow identifier (UUID).

Ejemplo:

"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8"

Parámetros de consulta

limit · string

Number of occurrences to compute (1-50; default 10).

Ejemplo:

"10"

Respuesta

200

application/json

Indicates that the request was successful and the response contains the requested data.

occurrences · object[] | null · requerido

Show child attributes