---
title: "Update Identity"
method: PATCH
path: "/api/admin/identities/{identity_id}"
tags: ["admin-identities"]
---

# Update Identity

`PATCH /api/admin/identities/{identity_id}`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/admin/identities/{identity_id}`
- Auth: none declared

Update an identity's is_active status and/or funding_mode (admin only).

TOS-5187: for a Clerk-authenticated person, `is_active` is no longer a
bare local flag - it is projected from an explicit Clerk ban/unban
command (`services.clerk_account_sync.admin_set_account_enabled`), so
this route and the account webhook always agree on where authority for
that value lives. Every payload field is validated BEFORE any mutation
(local or external): a bad `is_active` type or an unknown `funding_mode`
must never be discovered only after a Clerk command already ran.

## Path parameters

- `identity_id` string, uuid, required

## Request body

- object

## Response `200`

Successful Response

- IdentityOut
  - `id` string, uuid, required
  - `display_name` string, required
  - `email` string, nullable, required
  - `avatar_url` string, nullable, required
  - `role` string, required
  - `is_active` boolean, required
  - `created_at` string, nullable, required
  - `created_via` string, required
  - `is_test_fixture` boolean, required
  - `funding_mode` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `ce2c2ce318b1`: 2 info
  - added the required property `created_via` to the response with the `200` status
  - added the required property `is_test_fixture` to the response with the `200` status

[Operation history](https://skmtc.dev/thinqos/apis/thinqos-api/changes/api/admin/identities/:identity_id/patch.md)

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)