latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

PlanRun

Retrieve plan run summaries by plan ID (narrow agent path)

Lightweight query for agent tools. Returns a narrow subset of fields, uses keyset pagination, and requires plan_id.

get/planRuns/workspace/{workspace_id}/summaries

Path parameters

workspace_idstring required

The workspace ID

Query parameters

plan_idstring required

The plan ID to filter by

limitinteger

Max results to return (default 30, max 1000)

cursorstring

Keyset cursor for pagination (created_time_ms|plan_run_id)

statusstring

Optional status filter

min_created_timeinteger

Optional minimum created time in epoch milliseconds

max_created_timeinteger

Optional maximum created time in epoch milliseconds

environment_idstring

Optional environment filter; matches rows whose denormalized environment_ids contains this value

application_idstring

Optional application filter; matches rows whose denormalized application_ids contains this value

Response

Plan run summaries matching the query

cursorstring

Cursor used for pagination