---
title: "Changes to Update an agent"
method: PUT
path: "/agent/identities/{uid}"
---

# Changes to Update an agent

`PUT /agent/identities/{uid}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 9 revisions.

- **2026-10-19** `2c45dcc0a13e`: 18 breaking, 5 warning, 11 info
- **2026-10-13** `96d1e59a65c5`: 1 info
- **2026-08-15** `a0daf9e59774`: 1 breaking, 1 warning, 26 info

## Changes

- **2026-10-19** `2c45dcc0a13e`: 18 breaking, 5 warning, 11 info
  - the request property `base_harness` became not nullable
  - the request property `base_model` became not nullable
  - the request property `credential_strategy` became not nullable
  - the request property `default_runner_uid` became not nullable
  - the request property `description` became not nullable
  - the request property `environment_id` became not nullable
  - the request property `harness` became not nullable
  - the request property `harness_auth_secrets` became not nullable
  - the request property `inference_providers` became not nullable
  - the request property `memory` became not nullable
  - the request property `on_behalf_of_enabled` became not nullable
  - the request property `prompt` became not nullable
  - the request property `secrets` became not nullable
  - the request property `skills` became not nullable
  - the request property `worker_host` became not nullable
  - the `inference_providers` request property type changed from `object` to no type
  - added `#/components/schemas/ExternalHarness, subschema #1` to the `harness/allOf[#/components/schemas/Harness]/type` response property `oneOf` list for the response status `200`
  - the `harness/allOf[#/components/schemas/Harness]/type` response's property type changed from `string` to no type for status `200`
  - removed `#/components/schemas/AgentCredentialStrategy` from the `credential_strategy` request property `allOf` list
  - removed `#/components/schemas/AgentMemoryUpdateConfig` from the `memory` request property `allOf` list
  - removed `#/components/schemas/Harness` from the `harness` request property `allOf` list
  - removed `#/components/schemas/HarnessAuthSecrets` from the `harness_auth_secrets` request property `allOf` list
  - removed `#/components/schemas/InferenceProvidersConfig` from the `inference_providers` request property `allOf` list
  - added `#/components/schemas/AgentCredentialStrategy, subschema #2` to the `credential_strategy` request property `oneOf` list
  - added `#/components/schemas/AgentMemoryUpdateConfig, subschema #2` to the `memory` request property `oneOf` list
  - added `#/components/schemas/Harness, subschema #2` to the `harness` request property `oneOf` list
  - added `#/components/schemas/HarnessAuthSecrets, subschema #2` to the `harness_auth_secrets` request property `oneOf` list
  - added `#/components/schemas/InferenceProvidersConfig, subschema #2` to the `inference_providers` request property `oneOf` list
  - added the optional property `harness_auth_secrets/allOf[#/components/schemas/HarnessAuthSecrets]/pi_auth_secret_name` to the response with the `200` status
  - added the optional property `inference_providers/allOf[#/components/schemas/InferenceProvidersConfig]/aws/role_arn_source` to the response with the `200` status
  - removed the `claude` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `200`
  - removed the `codex` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `200`
  - removed the `gemini` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `200`
  - removed the `oz` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `200`
- **2026-10-13** `96d1e59a65c5`: 1 info
  - added the new optional request property `secrets_append`
- **2026-08-15** `a0daf9e59774`: 1 breaking, 1 warning, 26 info
  - removed the required property `memory_stores` from the response with the `200` status
  - removed the request property `memory_stores`
  - added the new optional request property `credential_strategy`
  - added the new optional request property `default_runner_uid`
  - added the new optional request property `harness`
  - added the new optional request property `mcp_servers`
  - added the new optional request property `memory`
  - added the new optional request property `on_behalf_of_enabled`
  - added the new optional request property `worker_host`
  - request property `base_harness` deprecated
  - 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 `auth_url` to the response with the `404` status
  - added the optional property `auth_url` to the response with the `500` status
  - added the optional property `credential_strategy` to the response with the `200` status
  - added the optional property `harness` to the response with the `200` status
  - added the optional property `mcp_servers` to the response with the `200` status
  - added the optional property `on_behalf_of_enabled` to the response with the `200` 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
  - added the optional property `provider` to the response with the `404` status
  - added the optional property `provider` to the response with the `500` status
  - added the optional property `worker_host` to the response with the `200` status
  - response property `base_harness` deprecated
  - added the required property `default_runner_uid` to the response with the `200` status
  - added the required property `memory` to the response with the `200` status

---

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