runs

List recent execution history across jobs, webhooks, package apps, workflows, ad-hoc execute, and other runtimes so y...

List recent execution history across jobs, webhooks, package apps, workflows, ad-hoc execute, and other runtimes so you can debug failures or inspect what ran. Ad-hoc execute runs are included for both success and error. Terminal rows may include a bounded metadata.result snapshot. By default, ignored/resolved error runs are hidden (error_triage defaults to open); use runUpdate or runUpdateBulk to triage noise, or pass error_triage all/ignored/resolved to inspect those rows. Pass status success (or omit status with error_triage all) for a recent "what ran" list. Records are retained about 30 days, capped per user, and cap-pruned in this order: handled errors, successes, then open errors.

Org permission: job:read.

get/v1/runs

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/runs
  • Auth: HTTP bearer

Query parameters

surface'execute' | 'export' | 'subscription' | 'app_fetch' | 'app_realtime' | 'job' | 'workflow' | 'retriever' | 'webhook'

Optional runtime surface filter such as job, webhook, execute, app_fetch, or workflow.

status'running' | 'success' | 'error'

Optional status filter: running, success, or error.

package_idstring

Optional saved package id to scope package-owned runs.

job_idstring

Optional job id to list runs for one scheduled job.

workflow_idstring

Optional workflow run id (dynwf-… or pkgwf-…) from workflows.create. Returns that workflow's run, whose metadata.result holds the return value once it succeeds.

sincestring

Optional ISO 8601 lower bound on started_at (inclusive), for example 2026-07-01T00:00:00.000Z.

error_triage'open' | 'ignored' | 'resolved' | 'all'

Soft error-triage filter. Defaults to open (hides ignored/resolved noise). Use ignored, resolved, or all to inspect triaged runs.

limitinteger

Page size (default 25, max 100).

cursorstring

Opaque pagination cursor from a previous next_cursor value.

Response

Success.

next_cursorstring nullable required

Opaque cursor for the next page, or null when this is the last page.

Changes

No recorded changes to this operation across all 2 revisions of this API.