WHwherobots
triggers

List a task schedule's run journal

Changed on

A trigger is a task schedule: it runs a task on a recurring fixed-interval or cron schedule (cron uses an IANA timezone), and each execution is a task run. The task is an organization-owned task created from an S3 Python file or JAR; platform tasks cannot be scheduled.

One entry per tick, gap, or manual root, with its latest attempt and up to 20 attempts. Filters and pagination apply to entries, not attempts. Archived triggers remain readable.

get/triggers/{trigger_id}/runs

Request

  • Base URL
    https://api.cloud.wherobots.com
  • URL
    https://api.cloud.wherobots.com/triggers/{trigger_id}/runs
  • Auth
    • HTTP bearer
    • or API key in header X-API-Key

Path parameters

trigger_idstring required

Query parameters

kindTriggerRunEntryKind[] nullable

Match any of these entry kinds. Repeat for several kinds; omit for all.

stateTaskRunState[] nullable

Match the latest attempt's projected state. Repeat for several states.

needsRecoveryboolean

Keep entries whose latest attempt is FAILED, TIMED_OUT, SKIPPED, MISSED or REJECTED, or whose latest attempt is a rerun in PENDING, SUBMITTED, RUNNING or CANCELLING (recovery in progress). Combines with kind, state and batch time bounds using AND.

batchTimeFromstring date-time nullable

Inclusive batch time bound; excludes manual entries.

batchTimeTostring date-time nullable

Exclusive batch time bound; excludes manual entries.

limitinteger

Page size limit

offsetinteger

Page offset

Response

Successful Response

totalinteger required
limitinteger required
offsetinteger required

Changes

  • 54fa857fb12dRevision changes
    • warning

      added the new SCRIPT_OWNER_MISMATCH enum value to the // response property for the response status

    • warning

      added the new SCRIPT_OWNER_MISMATCH enum value to the // response property for the response status

    • warning

      added the new SCRIPT_OWNER_MISMATCH enum value to the // response property for the response status

    • warning

      added the new SCRIPT_OWNER_MISMATCH enum value to the // response property for the response status

    • warning

      added the new SCRIPT_OWNER_MISMATCH enum value to the // response property for the response status

    • warning

      added the new SCRIPT_OWNER_MISMATCH enum value to the // response property for the response status

    • warning

      added the new SCRIPT_OWNER_MISMATCH enum value to the // response property for the response status

  • bd4db9c535c1Revision changes
    • warning

      added the new missed enum value to the ///// response property for the response status

    • warning

      added the new missed enum value to the //// response property for the response status

    • warning

      added the new missed enum value to the //// response property for the response status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status