Ramp: Update a user — request body — body
Update a user: request body, field body. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Update a user — request body — body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
auto_promote | boolean | Optional | Whether to automatically promote the users manager to manager. |
department_id | string | Optional | Unique identifier of the employee’s department Format: uuid |
direct_manager_id | JSON | Optional | |
direct_manager_id (anyOf 1) | string | Alternative | Unique identifier of the employee’s direct manager Format: uuid |
direct_manager_id (anyOf 2) | null | Alternative | |
first_name | string | Optional | Minimum length: 1 |
is_manager | boolean | Optional | Whether the employee is a manager |
last_name | string | Optional | Minimum length: 1 |
location_id | string | Optional | Unique identifier of the employee’s location Format: uuid |
role | string | Optional | The employee’s role; It could be one of the following values: Admin, Cardholder, Bookkeeper; Note that Owner is not a permissible value. One of: AUDITOR, BUSINESS_ADMIN, BUSINESS_BOOKKEEPER, BUSINESS_OWNER, BUSINESS_USER, GUEST_USER, IT_ADMIN |
scheduled_deactivation_date | JSON | Optional | |
scheduled_deactivation_date (anyOf 1) | string | Alternative | The date when the user is scheduled to be deactivated. Set to null to clear. Cannot be set for admins or owners. Format: date |
scheduled_deactivation_date (anyOf 2) | null | Alternative |