User

Update User

Changed on

Used to update existing users

patch/users/{id}

Request

  • Base URL: https://api.mabl.com
  • URL: https://api.mabl.com/users/{id}
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

idstring required

The user ID to update

Headers

If-Matchstring

If-Match header according to http/1.1 spec section 14.24. Allows for enforced atomic updates, to prevent update collisions

Request body

idstring

Unique identifier representing a specific user

created_timeinteger

Time at which the user was created

created_by_idstring

The ID of the user who created this user

desktop_app_installedboolean

Flag indicating whether or not the user has installed electron app

last_updated_timeinteger

Time at which the user was last updated

last_updated_by_idstring

The ID of the user who last updated this user

emailstring

The user's E-Mail address

email_verifiedboolean

Flag indicating whether or not the user's e-mail address has been verified

namestring

The user's full name

given_namestring

The user's first/given name

family_namestring

The user's surname

nicknamestring

The user's nickname

localestring

The user's locale

picturestring

URL of the user's picture

firebase_tokenstring

Token to use for Firebase authentication

onboardedboolean

flag indicating whether the workspace the user has joined has gone through onboarding

accepted_invitationboolean

flag indicating whether the user has ever accepted invitation to any workspace

companystring

The user's company

phonestring

The user's phone number

type'agent' | 'normal'

Classification of the user. A null/unset value is equivalent to normal and is the default for existing users. agent users are synthetic users created to act on behalf of AI agent sessions that were initiated by an API key rather than a human user.

Response

The updated user

idstring

Unique identifier representing a specific user

created_timeinteger

Time at which the user was created

created_by_idstring

The ID of the user who created this user

desktop_app_installedboolean

Flag indicating whether or not the user has installed electron app

last_updated_timeinteger

Time at which the user was last updated

last_updated_by_idstring

The ID of the user who last updated this user

emailstring

The user's E-Mail address

email_verifiedboolean

Flag indicating whether or not the user's e-mail address has been verified

namestring

The user's full name

given_namestring

The user's first/given name

family_namestring

The user's surname

nicknamestring

The user's nickname

localestring

The user's locale

picturestring

URL of the user's picture

firebase_tokenstring

Token to use for Firebase authentication

onboardedboolean

flag indicating whether the workspace the user has joined has gone through onboarding

accepted_invitationboolean

flag indicating whether the user has ever accepted invitation to any workspace

companystring

The user's company

phonestring

The user's phone number

type'agent' | 'normal'

Classification of the user. A null/unset value is equivalent to normal and is the default for existing users. agent users are synthetic users created to act on behalf of AI agent sessions that were initiated by an API key rather than a human user.

Changes

  • e170ce57c13cRevision changes
    • info

      added the new optional request property /

    • info

      added the optional property / to the response with the status