AUautify
Triggers – Plans

List plan runs

Lists a plan's runs, newest first, without per-case detail. Use GET /api/triggers/plans/{planId}/runs/{planRunId} for the per-case breakdown of a single run. Paginate by passing the previous page's nextCursor as cursor. Archived (soft-deleted) runs are excluded; they remain readable via the by-id endpoint, flagged by archivedAt.

get/api/triggers/plans/{planId}/runs

Request

Path parameters

planIdstring uuid required

UUID of the test plan.

Query parameters

tagstring[]

Filter by tag. Repeat the parameter to narrow further: a row matches only if it carries every given tag (?tag=git:sha:abc&tag=genesis:pr:42). At most 10, each 1-64 characters; more is refused with 400. Matching is exact and scoped to your organization.

limitinteger

Maximum number of runs to return.

cursorstring date-time

Pagination cursor — the nextCursor value from the previous page (the createdAt of its last run, ISO 8601).

sort'createdAt' | 'startedAt' | 'status'

Field to order the list by. cursor is only supported with the default sort (createdAt); ordering by anything else returns 400.

order'asc' | 'desc'
locale'en' | 'ja' | 'ko' | 'und'

ICU collation used to order text fields, so Japanese titles sort by gojuon rather than by byte value. Omit for a locale-independent order.

Response

Runs for the plan, newest first.

hasMoreboolean

More runs exist beyond this page. Unlike nextCursor, this is accurate for every sort and order.

nextCursorstring date-time

Cursor for the next page. Only emitted on the default sort (createdAt, desc), because the cursor is a createdAt compared with a strict less-than and describes a position in no other ordering. Use hasMore to detect further pages.

Example response

{
  "items": [
    {
      "tags": [
        "git:sha:3f2c1e9a7b6d5c4e3f2a1b0c9d8e7f6a5b4c3d2e",
        "genesis:pr:1234"
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.