--- title: "Changes to List agent runs" method: GET path: "/agent/runs" --- # Changes to List agent runs `GET /agent/runs` > Every recorded change to this operation, newest first. ## Timeline Changed in 6 of 9 revisions. - **2026-11-04** `4b5d145669be`: 2 info - **2026-10-19** `2c45dcc0a13e`: 4 breaking, 18 info - **2026-10-13** `96d1e59a65c5`: 26 breaking, 9 warning, 20 info - **2026-10-06** `3ed2d06a7997`: 1 breaking - **2026-09-09** `4a13a21e49d9`: 7 info - **2026-08-15** `a0daf9e59774`: 1 breaking, 7 warning, 26 info ## Changes - **2026-11-04** `4b5d145669be`: 2 info - added the optional property `runs/items/diagnostics` to the response with the `200` status - added the optional property `runs/items/request_usage/platform_duration_seconds` to the response with the `200` status - **2026-10-19** `2c45dcc0a13e`: 4 breaking, 18 info - response property `runs/items/agent_config/credential_strategy` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - added `#/components/schemas/ExternalHarness, subschema #1` to the `runs/items/agent_config/harness/type` response property `oneOf` list for the response status `200` - the `runs/items/agent_config/harness/type` response's property type changed from `string` to no type for status `200` - removed the required property `runs/items/artifacts/items/oneOf[#/components/schemas/FileArtifact]/data/thumbnail/expires_at` from the response with the `200` status - added the optional property `runs/items/agent_config/harness_auth_secrets/pi_auth_secret_name` to the response with the `200` status - added the optional property `runs/items/agent_config/inference_providers/allOf[#/components/schemas/InferenceProvidersConfig]/aws/role_arn_source` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/byok_inference_usage/additionalProperties/web_fetch_cost_in_cents` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/byok_inference_usage/additionalProperties/web_fetch_cost_in_credits` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/byok_inference_usage/additionalProperties/web_fetch_page_count` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/custom_endpoint_inference_usage/additionalProperties/web_fetch_cost_in_cents` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/custom_endpoint_inference_usage/additionalProperties/web_fetch_cost_in_credits` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/custom_endpoint_inference_usage/additionalProperties/web_fetch_page_count` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/direct_api_inference_usage/additionalProperties/web_fetch_cost_in_cents` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/direct_api_inference_usage/additionalProperties/web_fetch_cost_in_credits` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category/additionalProperties/direct_api_inference_usage/additionalProperties/web_fetch_page_count` to the response with the `200` status - removed the `CREATOR` enum value from the `runs/items/agent_config/credential_strategy` response property for the response status `200` - removed the `EXECUTOR` enum value from the `runs/items/agent_config/credential_strategy` response property for the response status `200` - removed the `claude` enum value from the `runs/items/agent_config/harness/type` response property for the response status `200` - removed the `codex` enum value from the `runs/items/agent_config/harness/type` response property for the response status `200` - removed the `gemini` enum value from the `runs/items/agent_config/harness/type` response property for the response status `200` - removed the `oz` enum value from the `runs/items/agent_config/harness/type` response property for the response status `200` - added the required property `runs/items/request_usage/usage_by_category/additionalProperties/platform_usage_duration_seconds` to the response with the `200` status - **2026-10-13** `96d1e59a65c5`: 26 breaking, 9 warning, 20 info - removed the enum value `API` from the `query` request parameter `source` - removed the enum value `AUTOFIX` from the `query` request parameter `source` - removed the enum value `CLI` from the `query` request parameter `source` - removed the enum value `CLOUD_MODE` from the `query` request parameter `source` - removed the enum value `GITHUB_ACTION` from the `query` request parameter `source` - removed the enum value `GITHUB_WEBHOOK` from the `query` request parameter `source` - removed the enum value `GITLAB_WEBHOOK` from the `query` request parameter `source` - removed the enum value `JIRA` from the `query` request parameter `source` - removed the enum value `LINEAR` from the `query` request parameter `source` - removed the enum value `LOCAL` from the `query` request parameter `source` - removed the enum value `ORCHESTRATION` from the `query` request parameter `source` - removed the enum value `RUN_SCORER` from the `query` request parameter `source` - removed the enum value `SCHEDULED_AGENT` from the `query` request parameter `source` - removed the enum value `SELF_IMPROVEMENT` from the `query` request parameter `source` - removed the enum value `SLACK` from the `query` request parameter `source` - removed the enum value `WEB_APP` from the `query` request parameter `source` - the `runs/items/artifacts/items/oneOf[#/components/schemas/PullRequestArtifact]/data` response's property type changed from `object` to no type for status `200` - removed the required property `runs/items/artifacts/items/oneOf[#/components/schemas/PullRequestArtifact]/data/branch` from the response with the `200` status - removed the required property `runs/items/artifacts/items/oneOf[#/components/schemas/PullRequestArtifact]/data/url` from the response with the `200` status - removed the required property `runs/items/request_usage/usage_by_category/additionalProperties/byok_inference_usage/additionalProperties/cost_usd` from the response with the `200` status - removed the required property `runs/items/request_usage/usage_by_category/additionalProperties/byok_inference_usage/additionalProperties/web_search_cost_usd` from the response with the `200` status - removed the required property `runs/items/request_usage/usage_by_category/additionalProperties/custom_endpoint_inference_usage/additionalProperties/cost_usd` from the response with the `200` status - removed the required property `runs/items/request_usage/usage_by_category/additionalProperties/custom_endpoint_inference_usage/additionalProperties/web_search_cost_usd` from the response with the `200` status - removed the required property `runs/items/request_usage/usage_by_category/additionalProperties/direct_api_inference_usage/additionalProperties/cost_usd` from the response with the `200` status - removed the required property `runs/items/request_usage/usage_by_category/additionalProperties/direct_api_inference_usage/additionalProperties/web_search_cost_usd` from the response with the `200` status - removed the required property `runs/items/request_usage/usage_by_category/additionalProperties/platform_usage_usd` from the response with the `200` status - removed the optional property `runs/items/request_usage/inference_cost_breakdown_usd` from the response with the `200` status - added the new `AZURE_DEVOPS_WEBHOOK` enum value to the `runs/items/source` response property for the response status `200` - added the new `BENCHMARK_TRIAL` enum value to the `runs/items/source` response property for the response status `200` - added the new `CREATE_BENCHMARK_TASK` enum value to the `runs/items/source` response property for the response status `200` - added the new `CUSTOM_WEBHOOK` enum value to the `runs/items/source` response property for the response status `200` - added the new `MCP` enum value to the `runs/items/source` response property for the response status `200` - added the new `TEAMS` enum value to the `runs/items/source` response property for the response status `200` - added the new `agent_stream_failure` enum value to the `runs/items/status_message/error_code` response property for the response status `200` - added the new `agent_stream_network_error` enum value to the `runs/items/status_message/error_code` response property for the response status `200` - added the new optional `query` request parameter `factory_uid` - added the new optional `query` request parameter `task_status` - for the `query` request parameter `source`, the type was generalized from `string` to `array` - added the optional property `runs/items/agent_config/secrets` to the response with the `200` status - added the optional property `runs/items/artifacts/items/oneOf[#/components/schemas/FileArtifact]/data/thumbnail` to the response with the `200` status - …15 more - **2026-10-06** `3ed2d06a7997`: 1 breaking - the `runs/items/agent_config/idle_timeout_minutes` response property's min was decreased from `1.00` to `0.00` for the response status `200` - **2026-09-09** `4a13a21e49d9`: 7 info - added the new optional `header` request parameter `X-Warp-Team-Uid` - added the optional property `runs/items/agent_config/computer_use_model_id` to the response with the `200` status - added the optional property `runs/items/debug_agent_available` to the response with the `200` status - added the optional property `runs/items/request_usage/inference_cost_breakdown_usd` to the response with the `200` status - added the optional property `runs/items/request_usage/total_tokens` to the response with the `200` status - added the optional property `runs/items/request_usage/usage_by_category` to the response with the `200` status - added the optional property `runs/items/status_message/debug_agent_active` to the response with the `200` status - **2026-08-15** `a0daf9e59774`: 1 breaking, 7 warning, 26 info - added `#/components/schemas/ExternalReferenceArtifact` to the `runs/items/artifacts/items/` response property `oneOf` list for the response status `200` - added the new `AUTOFIX` enum value to the `runs/items/source` response property for the response status `200` - added the new `GITHUB_WEBHOOK` enum value to the `runs/items/source` response property for the response status `200` - added the new `GITLAB_WEBHOOK` enum value to the `runs/items/source` response property for the response status `200` - added the new `JIRA` enum value to the `runs/items/source` response property for the response status `200` - added the new `ORCHESTRATION` enum value to the `runs/items/source` response property for the response status `200` - added the new `RUN_SCORER` enum value to the `runs/items/source` response property for the response status `200` - added the new `SELF_IMPROVEMENT` enum value to the `runs/items/source` response property for the response status `200` - added the new optional `query` request parameter `metadata` - added the new enum value `AUTOFIX` to the `query` request parameter `source` - added the new enum value `EXTERNAL_REFERENCE` to the `query` request parameter `artifact_type` - added the new enum value `GITHUB_WEBHOOK` to the `query` request parameter `source` - added the new enum value `GITLAB_WEBHOOK` to the `query` request parameter `source` - added the new enum value `JIRA` to the `query` request parameter `source` - added the new enum value `ORCHESTRATION` to the `query` request parameter `source` - added the new enum value `RUN_SCORER` to the `query` request parameter `source` - added the new enum value `SELF_IMPROVEMENT` to the `query` request parameter `source` - added the non-success response with the status `403` - added the optional property `auth_url` to the response with the `400` status - added the optional property `auth_url` to the response with the `401` status - added the optional property `provider` to the response with the `400` status - added the optional property `provider` to the response with the `401` status - added the optional property `runs/items/agent_config/credential_strategy` to the response with the `200` status - added the optional property `runs/items/agent_config/harness/model_id` to the response with the `200` status - added the optional property `runs/items/agent_config/harness/reasoning_level` to the response with the `200` status - added the optional property `runs/items/agent_config/runner_id` to the response with the `200` status - added the optional property `runs/items/artifacts/items/oneOf[#/components/schemas/FileArtifact]/data/title` to the response with the `200` status - added the optional property `runs/items/is_run_type_cancellable` to the response with the `200` status - added the optional property `runs/items/metadata` to the response with the `200` status - added the optional property `runs/items/request_usage/compute_cost_usd` to the response with the `200` status - added the optional property `runs/items/request_usage/inference_cost_usd` to the response with the `200` status - added the optional property `runs/items/request_usage/platform_cost_usd` to the response with the `200` status - added the optional property `runs/items/status_message/session_debug_until` to the response with the `200` status - added `EXTERNAL_REFERENCE` discriminator mapping keys to the `runs/items/artifacts/items/` response property for the response status `200` --- [Operation](https://skmtc.dev/warp/apis/oz-agent-api/docs/agent/runs/get.md) - [API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [Page](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/runs/get)