Skip to main content
Docs

Search guides and API endpoints, for example “Idempotency-Key” or “submit job”.

    API reference

    Events

    Job and workflow run completion events: gap-free cursor feed with optional long-poll. Thin events; re-read status.

    List job / workflow run completion events

    GET/api/v1/events

    API key or token

    The caller's stop transitions, oldest first, retained 7 days.

    Delivery is at-least-once and gap-free: dedupe on event_id. Events are thin; re-read /jobs/status or /workflows/runs/{run_id} for detail.

    Parameters

    Query parameters
    NameTypeDescription
    afterstring

    Cursor from a previous response; omit for the oldest retained.

    Limits: max length 41

    kindstring

    One of: "job", "workflow_run"

    subject_idstring

    Limits: min length 1, max length 100

    limitinteger

    Default: 50Limits: ≥ 1, ≤ 100

    waitnumber

    Seconds to hold the request open when there are no events.

    Default: 0Limits: ≥ 0, ≤ 25

    Example request

    curl "https://api.cognichem.com/api/v1/events" \
  -H "X-Api-Key: $COGNICHEM_API_KEY"

    Responses

    Successful Response · application/json · RunEventsResponse

    Response fields
    FieldTypeDescription
    events[]requiredRunEvent[]
    events.cursorrequiredstring

    Opaque cursor positioned at this event.

    events.event_idrequiredinteger

    Dedupe key (at-least-once delivery).

    events.kindrequiredstring

    One of: "job", "workflow_run"

    events.occurred_atrequiredstring (date-time)
    events.statusrequiredstring

    Jobs: completed | error | cancelled. Workflow runs: completed | failed | cancelled | paused.

    events.subject_idrequiredstring

    Job id or workflow run id.

    events.workflow_run_idstring | null

    Owning run when the job is a workflow step.

    next_cursorstring | null

    Pass as after on the next call. Unchanged when no events.

    Example 200 response
    {
  "events": [
    {
      "cursor": "1121.42",
      "event_id": 42,
      "kind": "job",
      "occurred_at": "2026-09-27T12:00:00Z",
      "status": "completed",
      "subject_id": "job-01J..."
    }
  ],
  "next_cursor": "1121.42"
}