---
title: "Changes to Retrieve an agent"
method: GET
path: "/agent/identities/{uid}"
---

# Changes to Retrieve an agent

`GET /agent/identities/{uid}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 9 revisions.

- **2026-10-19** `2c45dcc0a13e`: 2 breaking, 6 info
- **2026-08-15** `a0daf9e59774`: 1 breaking, 14 info

## Changes

- **2026-10-19** `2c45dcc0a13e`: 2 breaking, 6 info
  - 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`
  - 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-08-15** `a0daf9e59774`: 1 breaking, 14 info
  - removed the required property `memory_stores` from the response with the `200` 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 `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 `401` 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/get.md) - [API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [Page](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/identities/:uid/get)