v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB

organization-users

Update a user

Update details about an existing user.

patch/v3/users/{userId}

Path parameters

userIdstring required

BILL-generated ID of the user. The value begins with 006.

Example:{{org_user_id}}

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}

devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

firstNamestring

User first name

lastNamestring

User last name

roleIdstring

BILL-generated ID of the user role. The value begins with 0po.

If you do not set roleId, the default ADMINISTRATOR user role is assigned to the created user. You can get the list of available user roles with GET /v3/roles.

Example request

{
  "lastName": "Billson"
}

Response

Update a user response

idstring

BILL-generated ID of the user. The value begins with 006.

archivedboolean

Set as true if the user is archived

firstNamestring

User first name

lastNamestring

User last name

emailstring

User email address

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time