---
title: "Changes to Update an identity"
method: PATCH
path: "/v2/identities/{id}"
---

# Changes to Update an identity

`PATCH /v2/identities/{id}`

> Every recorded change to this operation, newest first.
> 554 revisions in range; 71 not diffed.

## Timeline

Changed in 31 of 554 revisions.

- **2026-10-23** `0b4e519a544f`: 3 info
- **2026-10-23** `732aed62833a`: 2 warning, 1 info
- **2026-10-22** `4f826b2c3a0e`: 3 info
- **2026-10-22** `8f0dc569f247`: 2 warning, 1 info
- **2026-10-21** `08b800d640e6`: 3 info
- **2026-10-21** `3ce0047cb0a0`: 2 warning, 1 info
- **2026-10-20** `509fb3426748`: 3 info
- **2026-10-20** `fa3268994006`: 2 warning, 1 info
- **2026-10-20** `5e1d272a28f3`: 3 info
- **2026-10-20** `57adccdd4749`: 2 warning, 1 info
- **2026-10-19** `403429a2fc35`: 3 info
- **2026-10-18** `8b964b9663dc`: 2 warning, 1 info
- **2026-10-18** `f487125c9f92`: 3 info
- **2026-10-18** `5a692f00e432`: 2 warning, 1 info
- **2026-10-16** `35f4b82bace1`: 3 info
- **2026-10-16** `e27fe0c3b5e0`: 1 info
- **2026-10-15** `986f6f08390d`: 1 info
- **2026-10-15** `0099a1a884ed`: 1 info
- **2026-10-15** `715bf4305d7e`: 1 info
- **2026-08-28** `9642bb8e4f83`: 1 warning
- **2026-08-27** `a38e9ab59771`: 1 info
- **2026-07-17** `2f27caf6888c`: 1 info
- **2026-07-16** `bee257c5b248`: 1 warning
- **2026-07-16** `801f61a5a056`: 1 info
- **2026-07-16** `42d5d2062527`: 1 warning
- **2026-07-10** `d418091db163`: 1 info
- **2026-06-30** `877151607ea9`: 1 info
- **2026-06-04** `07b076404433`: 1 breaking, 12 warning, 2 info
- **2026-06-02** `81f56857e143`: 8 breaking, 7 warning, 3 info
- **2026-06-02** `bbd0d70989a7`: 2 breaking, 2 warning, 14 info
- **2026-05-27** `2e889aa00c82`: 1 info

## Changes

- **2026-10-23** `0b4e519a544f`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-23** `732aed62833a`: 2 warning, 1 info
  - added the new `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - added the new `BUDGET_PERIOD_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
  - removed the non-success response with the status `401`
- **2026-10-22** `4f826b2c3a0e`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-22** `8f0dc569f247`: 2 warning, 1 info
  - added the new `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - added the new `BUDGET_PERIOD_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
  - removed the non-success response with the status `401`
- **2026-10-21** `08b800d640e6`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-21** `3ce0047cb0a0`: 2 warning, 1 info
  - added the new `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - added the new `BUDGET_PERIOD_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
  - removed the non-success response with the status `401`
- **2026-10-20** `509fb3426748`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-20** `fa3268994006`: 2 warning, 1 info
  - added the new `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - added the new `BUDGET_PERIOD_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
  - removed the non-success response with the status `401`
- **2026-10-20** `5e1d272a28f3`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-20** `57adccdd4749`: 2 warning, 1 info
  - added the new `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - added the new `BUDGET_PERIOD_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
  - removed the non-success response with the status `401`
- **2026-10-19** `403429a2fc35`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-18** `8b964b9663dc`: 2 warning, 1 info
  - added the new `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - added the new `BUDGET_PERIOD_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
  - removed the non-success response with the status `401`
- **2026-10-18** `f487125c9f92`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-18** `5a692f00e432`: 2 warning, 1 info
  - added the new `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - added the new `BUDGET_PERIOD_UNSPECIFIED` enum value to the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
  - removed the non-success response with the status `401`
- **2026-10-16** `35f4b82bace1`: 3 info
  - added the non-success response with the status `401`
  - removed the `BUDGET_ALERT_DIMENSION_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts/items/dimension` response property for the response status `200`
  - removed the `BUDGET_PERIOD_UNSPECIFIED` enum value from the `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/limits/period` response property for the response status `200`
- **2026-10-16** `e27fe0c3b5e0`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-15** `986f6f08390d`: 1 info
  - added the non-success response with the status `401`
- **2026-10-15** `0099a1a884ed`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-15** `715bf4305d7e`: 1 info
  - added the non-success response with the status `401`
- **2026-08-28** `9642bb8e4f83`: 1 warning
  - removed the optional property `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/scope/allOf[#/components/schemas/BudgetScope]/factory` from the response with the `200` status
- **2026-08-27** `a38e9ab59771`: 1 info
  - added the optional property `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/scope/allOf[#/components/schemas/BudgetScope]/factory` to the response with the `200` status
- **2026-07-17** `2f27caf6888c`: 1 info
  - added the optional property `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts` to the response with the `200` status
- **2026-07-16** `bee257c5b248`: 1 warning
  - removed the optional property `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts` from the response with the `200` status
- **2026-07-16** `801f61a5a056`: 1 info
  - added the optional property `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts` to the response with the `200` status
- **2026-07-16** `42d5d2062527`: 1 warning
  - removed the optional property `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts` from the response with the `200` status
- **2026-07-10** `d418091db163`: 1 info
  - added the optional property `identity/allOf[#/components/schemas/Identity]/budget/allOf[#/components/schemas/Budget]/alerts` to the response with the `200` status
- **2026-06-30** `877151607ea9`: 1 info
  - added the optional property `identity/allOf[#/components/schemas/Identity]/budget` to the response with the `200` status
- **2026-06-04** `07b076404433`: 1 breaking, 12 warning, 2 info
  - the `identity` response's property type changed from `object` to no type for status `200`
  - removed the request property `id`
  - removed the optional property `identity/_id` from the response with the `200` status
  - removed the optional property `identity/avatar_url` from the response with the `200` status
  - removed the optional property `identity/created` from the response with the `200` status
  - removed the optional property `identity/display_name` from the response with the `200` status
  - removed the optional property `identity/email` from the response with the `200` status
  - removed the optional property `identity/external_id` from the response with the `200` status
  - removed the optional property `identity/metadata` from the response with the `200` status
  - removed the optional property `identity/metrics` from the response with the `200` status
  - removed the optional property `identity/tags` from the response with the `200` status
  - removed the optional property `identity/updated` from the response with the `200` status
  - removed the optional property `identity/workspace_id` from the response with the `200` status
  - added `#/components/schemas/Identity` to the `identity` response property `allOf` list for the response status `200`
  - the response property `identity` became required for the status `200`
- **2026-06-02** `81f56857e143`: 8 breaking, 7 warning, 3 info
  - request body became required
  - the request property `avatar_url` became not nullable
  - the request property `display_name` became not nullable
  - the request property `email` became not nullable
  - the `avatar_url` request property type changed from `string, null` to `string`, and format from `uri` to no format
  - the `email` request property type changed from `string, null` to `string`, and format from `email` to no format
  - removed the required property `_id` from the response with the `200` status
  - removed the required property `external_id` from the response with the `200` status
  - removed the optional property `avatar_url` from the response with the `200` status
  - removed the optional property `created` from the response with the `200` status
  - removed the optional property `display_name` from the response with the `200` status
  - removed the optional property `email` from the response with the `200` status
  - removed the optional property `metadata` from the response with the `200` status
  - removed the optional property `tags` from the response with the `200` status
  - removed the optional property `updated` from the response with the `200` status
  - added the new optional request property `id`
  - removed the non-success response with the status `404`
  - added the optional property `identity` to the response with the `200` status
- **2026-06-02** `bbd0d70989a7`: 2 breaking, 2 warning, 14 info
  - the `avatar_url` request property type changed from `string` to `string, null`, and format from no format to `uri`
  - the `email` request property type changed from `string` to `string, null`, and format from no format to `email`
  - removed the request property `id`
  - removed the optional property `identity` from the response with the `200` status
  - request body became optional
  - the request property `avatar_url` became nullable
  - the request property `display_name` became nullable
  - the request property `email` became nullable
  - added the non-success response with the status `404`
  - added the optional property `avatar_url` to the response with the `200` status
  - added the optional property `created` to the response with the `200` status
  - added the optional property `display_name` to the response with the `200` status
  - added the optional property `email` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - added the optional property `tags` to the response with the `200` status
  - added the optional property `updated` to the response with the `200` status
  - added the required property `_id` to the response with the `200` status
  - added the required property `external_id` to the response with the `200` status
- **2026-05-27** `2e889aa00c82`: 1 info
  - api tag `IdentitiesService` removed

---

[Operation](https://skmtc.dev/orq-ai/apis/orq-ai-api/docs/v2/identities/:id/patch.md) - [API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) - [Page](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/identities/:id/patch)
