v22

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-01140308542.4 KB
Users

Update user

Update a user

patch/zones/{zoneId}/users/{id}

Path parameters

zoneIdstring required

Zone ID

idstring required

User ID

Request body

identifierstring safe-text

Zone-scoped user identifier

status'active' | 'disabled'

Status of the user. Set to disabled to prevent the user from authenticating and revoke their active sessions, or active to re-enable.

Response

An authenticated user entity

idstring required

Unique identifier of the user

organization_idstring required

Organization that owns this user

zone_idstring required

Zone this user belongs to

identifierstring required

Zone-scoped user identifier. Defaults to the user's Keycard ID. When the provider has user_identifier_claim configured, the value is set from that claim at user creation time.

subjectstring

Subject identifier from the identity provider

issuerstring

Issuer identifier of the identity provider

emailstring email required

Email address of the user

email_verifiedboolean required

Whether the email address has been verified

status'active' | 'disabled' required

Status of the user. Disabled users cannot authenticate.

provider_idstring

Reference to the identity provider. This field is undefined when the source identity provider is deleted but the user is not deleted.

created_atstring date-time required

Entity creation timestamp

updated_atstring date-time required

Entity update timestamp

authenticated_atstring

Date when the user was last authenticated

session_countinteger

Session count for this user. Populated only when expand[]=session_count is set on the listing endpoint.

grant_countinteger

Delegated-grant count for this user. Populated only when expand[]=grant_count is set on the listing endpoint.