BRbrex-com
Users

Update user

Changed on

This endpoint updates a user. Any parameters not provided will be left unchanged.

put/v2/users/{id}

Request

  • Base URL
    https://api.brex.com
  • Auth
    OAuth 2
    Authorization codehttps://accounts-api.brex.com/oauth2/default/v1/authorize
    Token URLhttps://accounts-api.brex.com/oauth2/default/v1/token
    Scopesusers
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Headers

Idempotency-Keystring nullable

Request body

status'ACTIVE' | 'DISABLED' | 'ARCHIVED' | 'INACTIVE' | 'DELETED'

Acceptable user status for update. The value you send is the status the user ends up in. Only transitions that are legal for the user's current status are accepted; anything else is rejected with a 400.

  ACTIVE   <-->  DISABLED     suspend an active user / unsuspend a suspended one
  INACTIVE <-->  ARCHIVED     archive an inactive user / restore an archived one

  INVITED   -->  DELETED      withdraw an invitation and delete user
  INACTIVE  -->  DELETED      delete an inactive user
manager_idstring nullable

The user id of the manager of this user

department_idstring nullable
location_idstring nullable
title_idstring nullable
cost_center_idstring nullable
legal_entity_idstring

The legal entity this user reports into. Cannot be null.

metadataobject nullable

The metadata or customized attributes of the user. Maximum number of entries: 100

Response

updateUser 200 response

idstring required
first_namestring required

First name of the user

last_namestring required

Last name of the user

emailstring required

Email address of the user

status'INVITED' | 'ACTIVE' | 'DISABLED' | 'PENDING_ACTIVATION' | 'INACTIVE' | 'ARCHIVED'

Status of the user

manager_idstring nullable

The user id of the manager of this user

department_idstring nullable
location_idstring nullable
title_idstring nullable
cost_center_idstring nullable
legal_entity_idstring nullable
metadataobject nullable

The metadata or customized attributes of the user. Maximum number of entries: 100

remote_display_idstring nullable

Identifier that is displayed on the IDP or HR system, eg, if OKTA identifies you as user xyz

Example response

{
  "custom_fields": [
    {
      "value": {
        "data": {
          "amount": 700,
          "currency": "USD"
        }
      }
    }
  ]
}

Changes

  • 76616101e54aRevision changes
    • info

      added the new ARCHIVED enum value to the request property ////

    • info

      added the new DELETED enum value to the request property ////

    • info

      added the new INACTIVE enum value to the request property ////

  • bcd2910f7020Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the CLOSED enum value from the //// response property for the response status

    • info

      removed the DELETED enum value from the //// response property for the response status