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"
    }
  ]
}

Autorizações

Authorization · string · header · obrigatório

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

Parâmetros de caminho

id · string · obrigatório

Workflow identifier (UUID).

Exemplo:

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

Parâmetros de consulta

limit · string

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

Exemplo:

"10"

Resposta

200

application/json

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

occurrences · object[] | null · obrigatório

Show child attributes