Skip to main content
PATCH
/
end-users
/
{id}
Update end user
curl --request PATCH \
  --url https://app.usechar.ai/api/end-users/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "organization_id": "<string>",
    "email": "<string>",
    "metadata": "<string>",
    "last_activity_at": "2023-11-07T05:31:56Z"
  }
}
'
{
  "id": "<string>",
  "organization_id": "<string>",
  "external_id": "<string>",
  "email": "<string>",
  "metadata": "<string>",
  "last_activity_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

WorkOS JWT token. Obtain via WorkOS AuthKit authentication flow. The token must include organization_id claim for organization-scoped endpoints.

Path Parameters

​
id
string<uuid>
required

Unique identifier (UUID) of the resource to update

Body

application/json
​
data
object
required

Object containing the fields to update

Response

OK

End user resource representing a user who interacts with embedded AI widgets. Identified by external_id from the embedding site.

​
id
string
required

Internal end user ID (UUID).

​
organization_id
string
required

WorkOS organization ID that owns the end user.

​
external_id
string
required

External user identifier from the embedding site or IDP token.

​
email
string | null
required

Optional email address provided by the identity provider.

​
metadata
string | null
required

JSON string with additional end user metadata.

​
last_activity_at
string<date-time> | null
required

Timestamp of the user's last activity (message sent).

​
created_at
string<date-time>
required

Timestamp when the end user was created.

​
updated_at
string<date-time>
required

Timestamp when the end user was last updated.