Update the authenticated identity's name

PATCH

/current-identity

Update the display name of the identity belonging to the caller of the request. The identity is never taken from a path or query parameter — it is always resolved from identity_id on the verified JWT, so a caller can only ever update their own identity. Only the name field is editable through this endpoint; any other property sent in the request body is ignored. The full, updated identity record is returned in the response.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

The authenticated identity's name was updated successfully.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/current-identity' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Jane A. Doe"
}'

Response Example

200 - Success

{
    "message": "Identity updated successfully",
    "status": "success",
    "data": {
        "id": "01HXYZ1234567890ABCDEFGHIJ",
        "name": "Jane A. Doe",
        "type": "user",
        "primary_email": "jane.doe@example.com",
        "reference": "IDT-8F2A1C7D",
        "parent": null,
        "status": "active",
        "created": 1722869520000,
        "updated": 1722955920000
    }
}

Modified at 2026-09-30 00:29:30

Transfer ownership of an entity

Retrieve the authenticated identity