Skip to content

Patch User Meta Data

PATCH
/v1/users/{user_id}/meta_data

Merge-patch a user’s meta_data JSONB. Requires users:write permission.

user_id
required
User Id
string
UserMetaDataPatch

Merge-patch a subset of the User.meta_data JSONB without overwriting unrelated keys.

object
patches
required
Patches
object
>= 1 properties
key
additional properties
any

Successful Response

Response[UserRead]
object
data
required
UserRead

Full representation of a User record returned from the API.

object
id
required
Id
string format: uuid
tenant_id
required
Tenant Id
string format: uuid
workos_org_id
required
Workos Org Id
string
created_at
required
Created At
string format: date-time
created_by_user_id
required
Created By User Id
string
updated_at
required
Updated At
string format: date-time
updated_by_user_id
required
Updated By User Id
string
archived_at
Any of:
string format: date-time
archived_by_user_id
Any of:
string
archive_reason
Any of:
string
deleted_at
Any of:
string format: date-time
deleted_by_user_id
Any of:
string
delete_reason
Any of:
string
workos_user_id
required
Workos User Id
string
email
required
Email
string
first_name
required
First Name
string
last_name
required
Last Name
string
avatar_url
Any of:
string
is_active
required
Is Active
boolean
meta_data
required
Meta Data
object
key
additional properties
any
last_sign_in_at
Any of:
string format: date-time
meta
ResponseMeta

Metadata included in every response envelope.

object
request_id
Any of:
string
organization_id
Any of:
string

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object