---
title: "Changes to Run a cloud agent"
method: POST
path: "/agent/runs"
---

# Changes to Run a cloud agent

`POST /agent/runs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 9 revisions.

- **2026-10-19** `2c45dcc0a13e`: 8 breaking, 3 info
- **2026-10-13** `96d1e59a65c5`: 1 info
- **2026-10-06** `3ed2d06a7997`: 1 info
- **2026-09-09** `4a13a21e49d9`: 2 info
- **2026-08-15** `a0daf9e59774`: 12 info

## Changes

- **2026-10-19** `2c45dcc0a13e`: 8 breaking, 3 info
  - the request property `config/credential_strategy` became not nullable
  - removed the enum value `CREATOR` of the request property `config/credential_strategy`
  - removed the enum value `EXECUTOR` of the request property `config/credential_strategy`
  - removed the enum value `claude` of the request property `config/harness/type`
  - removed the enum value `codex` of the request property `config/harness/type`
  - removed the enum value `gemini` of the request property `config/harness/type`
  - removed the enum value `oz` of the request property `config/harness/type`
  - the `config/harness/type` request property type changed from `string` to no type
  - added the new optional request property `config/harness_auth_secrets/pi_auth_secret_name`
  - request property `config/credential_strategy` list-of-types was widened by adding types `null` to media type `application/json`
  - added `#/components/schemas/ExternalHarness, subschema #1` to the `config/harness/type` request property `oneOf` list
- **2026-10-13** `96d1e59a65c5`: 1 info
  - added the new optional request property `config/secrets`
- **2026-10-06** `3ed2d06a7997`: 1 info
  - the `config/idle_timeout_minutes` request property's min was decreased from `1.00` to `0.00`
- **2026-09-09** `4a13a21e49d9`: 2 info
  - added the new optional `header` request parameter `X-Warp-Team-Uid`
  - added the new optional request property `config/computer_use_model_id`
- **2026-08-15** `a0daf9e59774`: 12 info
  - added the new optional request property `config/credential_strategy`
  - added the new optional request property `config/harness/model_id`
  - added the new optional request property `config/harness/reasoning_level`
  - added the new optional request property `config/runner_id`
  - added the new optional request property `metadata`
  - added the new optional request property `on_behalf_of`
  - 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 `auth_url` to the response with the `403` 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 `provider` to the response with the `403` status

---

[Operation](https://skmtc.dev/warp/apis/oz-agent-api/docs/agent/runs/post.md) - [API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [Page](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/runs/post)