v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
classifications

Update an employee

Update details about an existing employee.

patch/v3/classifications/employees/{id}

Path parameters

idstring required

BILL-generated ID of the employee. The value begins with emp.

Example:{{employee_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

Employee first name

lastNamestring

Employee last name

shortNamestring

Employee short name

parentIdstring

BILL-generated ID of the parent employee. You can set this field if this employee is a child object.

Example request

{
  "firstName": "James",
  "lastName": "Tarkowski"
}

Response

Update an employee response

idstring

BILL-generated ID of the employee. The value begins with emp.

firstNamestring

Employee first name

lastNamestring

Employee last name

shortNamestring

Employee short name

parentIdstring

BILL-generated ID of the parent employee. You can set this field if this employee is a child object.

archivedboolean

Set as true if the employee is archived

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time