API Reference
API Reference

/members

Updates a member. Required scope: w_members. Accessible with all token types.

Result

If a member is already in the process of being updated then a 422 Unprocessable Entity error is expected.

It is also important to note that when updating a new member, the following role inputs are not allowed and will result in a 422 Unprocessable Entity error:

  • Role no_access - if HRIS application is deactivated
  • Role no_access, HRIS role hris_no_access - if HRIS application is activated
  • Role different than admin when the member is the last admin of the account
  • Role different than hris_admin when the member is the last HRIS admin of the account
  • Role combination different than admin and hris_admin - if HRIS application is activated and member is the only one who is an admin and also an HRIS admin

Calling the PUT /members endpoint will update the given member and return it. An example of the response follows:

{
  "id": "3ff4d641",
  "name": "John Doe",
  "headline": "headline",
  "email": "john.doe@workable.com",
  "role": "simple",
  "hris_role": "hris_admin",
  "collaboration_rules":[]
}

Each member will have the following keys:

keytypedescription
idstringThe member identifier
namestringThe full name of the member
headlinestringThe headline of the member
emailstringThe email address of the member
rolestringThe member's role. Possible values are admin, simple, reviewerand no_access
hris_rolestringThe member's hris role. Possible values are hris_admin, hris_employeeand hris_no_access
collaboration_rulesArray An array of the collaboration rules the member has. Each rule contains the role of the member in the collaboration, an array of departments and an array of locations that this collaborations is applicable for. More info here
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!