---
title: "Changes to Update an Identity"
method: PUT
path: "/admin/identities/{id}"
---

# Changes to Update an Identity

`PUT /admin/identities/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 47 revisions.

- **2025-11-07** `5f08e5827b5e`: 1 breaking, 1 warning, 4 info
- **2025-02-25** `df2fe8db7397`: 1 warning, 3 info
- **2024-06-05** `344e70f3542d`: 2 warning
- **2024-02-20** `4f071812f3ea`: 5 warning, 1 info
- **2022-12-02** `b6e5ffa30d4c`: 6 breaking, 5 info
- **2022-06-01** `fca041c7721f`: 4 info
- **2022-03-22** `028a4cf83c15`: 1 info
- **2021-05-05** `381c760af46e`: 1 breaking

## Changes

- **2025-11-07** `5f08e5827b5e`: 1 breaking, 1 warning, 4 info
  - the response property `recovery_addresses/items/id` became optional for the status `200`
  - removed the request property `credentials/oidc/config/config`
  - added the new optional request property `credentials/oidc/config/providers/items/organization`
  - added the new optional request property `credentials/saml`
  - added the new optional request property `external_id`
  - added the optional property `external_id` to the response with the `200` status
- **2025-02-25** `df2fe8db7397`: 1 warning, 3 info
  - added the new `saml` enum value to the `credentials/additionalProperties/type` response property for the response status `200`
  - added the new optional request property `credentials/oidc/config/config/use_password_migration_hook`
  - added the new optional request property `credentials/oidc/config/providers/items/use_auto_link`
  - added the new optional request property `credentials/password/config/use_password_migration_hook`
- **2024-06-05** `344e70f3542d`: 2 warning
  - added the new `passkey` enum value to the `credentials/additionalProperties/type` response property for the response status `200`
  - added the new `profile` enum value to the `credentials/additionalProperties/type` response property for the response status `200`
- **2024-02-20** `4f071812f3ea`: 5 warning, 1 info
  - added the new `code` enum value to the `credentials/additionalProperties/type` response property for the response status `200`
  - added the new `code_recovery` enum value to the `credentials/additionalProperties/type` response property for the response status `200`
  - added the new `email` enum value to the `verifiable_addresses/items/via` response property for the response status `200`
  - added the new `link_recovery` enum value to the `credentials/additionalProperties/type` response property for the response status `200`
  - added the new `sms` enum value to the `verifiable_addresses/items/via` response property for the response status `200`
  - added the optional property `organization_id` to the response with the `200` status
- **2022-12-02** `b6e5ffa30d4c`: 6 breaking, 5 info
  - the response property `metadata_admin` became nullable for the status `200`
  - the response property `metadata_public` became nullable for the status `200`
  - the response property `verifiable_addresses/items/id` became optional for the status `200`
  - the `id` response's property format changed from `uuid4` to `uuid` for status `200`
  - the `recovery_addresses/items/id` response's property format changed from `uuid4` to `uuid` for status `200`
  - the `verifiable_addresses/items/id` response's property format changed from `uuid4` to `uuid` for status `200`
  - api operation id `adminUpdateIdentity` removed and replaced with `updateIdentity`
  - api tag `identity` added
  - api tag `v0alpha2` removed
  - added the new optional request property `credentials`
  - removed the non-success response with the status `500`
- **2022-06-01** `fca041c7721f`: 4 info
  - added the new optional request property `metadata_admin`
  - added the new optional request property `metadata_public`
  - added the optional property `metadata_admin` to the response with the `200` status
  - added the optional property `metadata_public` to the response with the `200` status
- **2022-03-22** `028a4cf83c15`: 1 info
  - endpoint added
- **2021-05-05** `381c760af46e`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/ory/apis/ory-identities-api/docs/admin/identities/:id/put.md) - [API](https://skmtc.dev/ory/apis/ory-identities-api.md) - [Page](https://skmtc.dev/ory/apis/ory-identities-api/changes/admin/identities/:id/put)