Skip to content

Update user

Request

Update role, payment types, and/or delegation settings for an active employee. All fields in the request body are optional.

Security
BearerAuth
Path
client_idintegerrequired

The ID of the business.

Example:123
user_idintegerrequired

The ID of the user.

Bodyapplication/jsonrequired
role_idstring, (uuid)

The role to assign to the user. Must belong to the same business.

Example:"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
payment_typesArray of strings(PaymentType)

The payment types the user can transact with.

Items Enum:"bills""cards""reimbursements"
Example:
[
  "cards"
]
out_of_office_modeboolean

Whether the user is out of office. When true, both start and end dates are required.

Example:true
out_of_office_start_datestring, (date)

First day of the out-of-office period (inclusive).

Example:"2026-06-01"
out_of_office_end_datestring, (date)

Last day of the out-of-office period (inclusive). Must be on or after the start date.

Example:"2026-06-15"
delegate_approverinteger or null

The user ID to delegate approvals to while out of office. Must belong to the same business and have no overlapping out-of-office period.

Example:789
expense_delegateArray of integers

Replaces the user's full set of expense assistants with these user IDs. A user can have at most 3 expense assistants. Each ID must belong to the same business, must be a different user (a user cannot be their own expense assistant), and must not be repeated. Expense assistants cannot be chained. A user who is themselves an expense assistant cannot be given assistants, and a user who already has assistants cannot be assigned as one. Omit this field to leave the current assistants unchanged, or send an empty array to remove them all.

Example:
[
  456,
  789
]
PATCH
/v1/businesses/{client_id}/users/{user_id}
curl -i -X PATCH \
  'https://public.letsweel.com/v1/businesses/123/users/{user_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "role_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "payment_types": [
      "cards"
    ],
    "out_of_office_mode": true,
    "out_of_office_start_date": "2026-06-01",
    "out_of_office_end_date": "2026-06-15",
    "delegate_approver": 789,
    "expense_delegate": [
      456,
      789
    ]
  }'

Responses

OK

Bodyapplication/json
idinteger

The ID of the user.

Example:123
first_namestring

The first name of the user.

Example:"John"
last_namestring

The last name of the user.

Example:"Doe"
namestring

The full name of the user or the display name if the user has set one.

Example:"John Doe"
emailstring, (email)

The email of the user.

Example:"john.doe@example.com"
rolestring

The role of the user.

Example:"Team Member"
role_idstring, (uuid)

The ID of the user's role.

Example:"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
is_deletedboolean

Whether the user is deleted.

Example:false
createdstring, (date-time)

The date and time when the user was created in UTC.

Example:"2024-01-01T00:00:00Z"
updatedstring, (date-time)

The date and time when the user was last updated in UTC.

Example:"2024-01-01T00:00:00Z"
payment_typesArray of strings(PaymentType)

The payment types the user can transact with.

Items Enum:"bills""cards""reimbursements"
Example:
[
  "cards"
]
out_of_office_modeboolean

Whether the user is out of office.

Example:true
out_of_office_start_datestring or null, (date)

First day of the out-of-office period (inclusive).

Example:"2026-06-01"
out_of_office_end_datestring or null, (date)

Last day of the out-of-office period (inclusive).

Example:"2026-06-15"
delegate_approverinteger or null

The user ID to delegate approvals to while out of office.

Example:789
expense_delegateArray of integers or null

The user IDs of this user's expense assistants (who can act on their expenses). Null if the business does not have the expense assistant feature.

Example:
[
  456,
  789
]
Response
{
  "id": 123,
  "first_name": "John",
  "last_name": "Doe",
  "name": "John Doe",
  "email": "john.doe@example.com",
  "role": "Team Member",
  "role_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "is_deleted": false,
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z",
  "payment_types": [
    "cards"
  ],
  "out_of_office_mode": true,
  "out_of_office_start_date": "2026-06-01",
  "out_of_office_end_date": "2026-06-15",
  "delegate_approver": 789,
  "expense_delegate": [
    456,
    789
  ]
}