Read MV workflow events

GET/api/v1/tasks/{taskId}/workflow/eventsCopy URL

Authentication · x-api-key

Read durable workflow events after a cursor. Save nextCursor and honor resetRequired when reconciling retained history.

All endpointsRequestResponsesCode

Request

taskIdpath · Required

string

afterquery · Optional

string

Responses

200 OK

application/json

• Response 200 · hasMoreRequired

  boolean

• Response 200 · historyRequired

  "tracked" | "legacy_incomplete"

• Response 200 · itemsRequired

  array<object>
  1 field

  • Response 200 · items[]Each item

    object
    8 fields

    • Response 200 · items[].dataRequired

      object
      11 fields

      • Response 200 · items[].data.attemptRequired

        integer | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.attempt · anyOf 1Alternative

          integer
          1 field

          • Response 200 · items[].data.attempt · anyOf 1See schema

            integer

            Expand this value in the interactive reference.

        • Response 200 · items[].data.attempt · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.attempt · anyOf 2See schema

            null

            Expand this value in the interactive reference.

      • Response 200 · items[].data.changesRequired

        object

      • Response 200 · items[].data.codeRequired

        string | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.code · anyOf 1Alternative

          string
          1 field

          • Response 200 · items[].data.code · anyOf 1See schema

            string

            Expand this value in the interactive reference.

        • Response 200 · items[].data.code · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.code · anyOf 2See schema

            null

            Expand this value in the interactive reference.

      • Response 200 · items[].data.entityIdRequired

        string

      • Response 200 · items[].data.entityTypeRequired

        string

      • Response 200 · items[].data.evidenceIdRequired

        string | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.evidenceId · anyOf 1Alternative

          string
          1 field

          • Response 200 · items[].data.evidenceId · anyOf 1See schema

            string

            Expand this value in the interactive reference.

        • Response 200 · items[].data.evidenceId · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.evidenceId · anyOf 2See schema

            null

            Expand this value in the interactive reference.

      • Response 200 · items[].data.logicalItemRequired

        string | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.logicalItem · anyOf 1Alternative

          string
          1 field

          • Response 200 · items[].data.logicalItem · anyOf 1See schema

            string

            Expand this value in the interactive reference.

        • Response 200 · items[].data.logicalItem · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.logicalItem · anyOf 2See schema

            null

            Expand this value in the interactive reference.

      • Response 200 · items[].data.nextActionAtRequired

        string | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.nextActionAt · anyOf 1Alternative

          string

          Format: date-time.

          1 field

          • Response 200 · items[].data.nextActionAt · anyOf 1See schema

            string

            Expand this value in the interactive reference.

            Format: date-time.

        • Response 200 · items[].data.nextActionAt · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.nextActionAt · anyOf 2See schema

            null

            Expand this value in the interactive reference.

      • Response 200 · items[].data.phaseRequired

        string | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.phase · anyOf 1Alternative

          string
          1 field

          • Response 200 · items[].data.phase · anyOf 1See schema

            string

            Expand this value in the interactive reference.

        • Response 200 · items[].data.phase · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.phase · anyOf 2See schema

            null

            Expand this value in the interactive reference.

      • Response 200 · items[].data.previousStateRequired

        string | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.previousState · anyOf 1Alternative

          string
          1 field

          • Response 200 · items[].data.previousState · anyOf 1See schema

            string

            Expand this value in the interactive reference.

        • Response 200 · items[].data.previousState · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.previousState · anyOf 2See schema

            null

            Expand this value in the interactive reference.

      • Response 200 · items[].data.stateRequired

        string | null

        May be null. Must match at least one alternative.

        2 fields / alternatives

        • Response 200 · items[].data.state · anyOf 1Alternative

          string
          1 field

          • Response 200 · items[].data.state · anyOf 1See schema

            string

            Expand this value in the interactive reference.

        • Response 200 · items[].data.state · anyOf 2Alternative

          null
          1 field

          • Response 200 · items[].data.state · anyOf 2See schema

            null

            Expand this value in the interactive reference.

    • Response 200 · items[].idRequired

      string

    • Response 200 · items[].sequenceRequired

      string

    • Response 200 · items[].sourceRequired

      string

    • Response 200 · items[].specversionRequired

      "1.0"

    • Response 200 · items[].subjectRequired

      string

    • Response 200 · items[].timeRequired

      string

    • Response 200 · items[].typeRequired

      string

• Response 200 · nextCursorRequired

  string

• Response 200 · resetRequiredRequired

  boolean

• Response 200 · taskIdRequired

  string

400 Bad Request

application/json

• Response 400 · errorRequired

  object
  3 fields

  • Response 400 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 400 · error.messageRequired

    string

    Human readable error message

  • Response 400 · error.detailsOptional

    object

    Additional error details (optional)

• Response 400 · successRequired

  false

  Always false for error responses

401 Unauthorized

application/json

• Response 401 · errorRequired

  object
  3 fields

  • Response 401 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 401 · error.messageRequired

    string

    Human readable error message

  • Response 401 · error.detailsOptional

    object

    Additional error details (optional)

• Response 401 · successRequired

  false

  Always false for error responses

403 Forbidden

application/json

• Response 403 · errorRequired

  object
  3 fields

  • Response 403 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 403 · error.messageRequired

    string

    Human readable error message

  • Response 403 · error.detailsOptional

    object

    Additional error details (optional)

• Response 403 · successRequired

  false

  Always false for error responses

404 Not Found

application/json

• Response 404 · errorRequired

  object
  3 fields

  • Response 404 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 404 · error.messageRequired

    string

    Human readable error message

  • Response 404 · error.detailsOptional

    object

    Additional error details (optional)

• Response 404 · successRequired

  false

  Always false for error responses

429 Too Many Requests

Request allowance or task admission capacity exceeded. Follow Retry-After when present; otherwise wait for active tasks and use bounded backoff. Limits do not guarantee throughput. For SSE, this is the HTTP connection response, not an event.

application/json

• Response 429 · errorRequired

  object
  3 fields

  • Response 429 · error.codeRequired

    string

    RATE_LIMITED for request and task admission rejections.

  • Response 429 · error.messageRequired

    string

  • Response 429 · error.detailsOptional

    object

    Optional and scope-dependent. Request limits supply scope/policy/type/limit/current/retryAfterSec. Task admission supplies inFlight/limit/tier, plus scope=apiKey for a key cap. IP rejection can omit details. In-flight rejection does not promise Retry-After.

    8 fields

    • Response 429 · error.details.currentOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.inFlightOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.limitOptional

      integer

      Minimum: 0.

    • Response 429 · error.details.policyOptional

      "operation" | "query"

    • Response 429 · error.details.retryAfterSecOptional

      integer

      Minimum: 1.

    • Response 429 · error.details.scopeOptional

      "user" | "api-key" | "ip" | "apiKey"

    • Response 429 · error.details.tierOptional

      "FREE" | "PREMIUM" | "ENTERPRISE"

    • Response 429 · error.details.typeOptional

      "rps" | "daily" | "monthly"

• Response 429 · successRequired

  false

  Default: false.

500 Internal Server Error

application/json

• Response 500 · errorRequired

  object
  3 fields

  • Response 500 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 500 · error.messageRequired

    string

    Human readable error message

  • Response 500 · error.detailsOptional

    object

    Additional error details (optional)

• Response 500 · successRequired

  false

  Always false for error responses

503 Service Unavailable

application/json

• Response 503 · errorRequired

  object
  3 fields

  • Response 503 · error.codeRequired

    string

    Application-specific error code (see error catalog)

  • Response 503 · error.messageRequired

    string

    Human readable error message

  • Response 503 · error.detailsOptional

    object

    Additional error details (optional)

• Response 503 · successRequired

  false

  Always false for error responses

Request example

Wrap lines

cURL

curl --globoff --request GET \
  --url 'https://api.omnapi.com/api/v1/tasks/{taskId}/workflow/events' \
  --header "x-api-key: $OMNAPI_KEY"

Node.js

const response = await fetch("https://api.omnapi.com/api/v1/tasks/{taskId}/workflow/events", {
  method: "GET",
  headers: {
    "x-api-key": process.env.OMNAPI_KEY,
  },
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.text());

Python

import os
import requests

response = requests.request(
    "GET", "https://api.omnapi.com/api/v1/tasks/{taskId}/workflow/events",
    headers={
        "x-api-key": os.environ["OMNAPI_KEY"],
    },
    timeout=60,
)
response.raise_for_status()
print(response.text)

Set URL and header variables.

Interactive API Explorer → · OpenAPI JSON