This article is intended for developers who are working on an integration and need to extract an organization's user_role_ids to assign specific Job Admin permissions to Greenhouse Recruiting users. You can use Greenhouse Recruiting's Harvest API to retrieve a full list of your organization's Job Admin levels with the endpoint GET: List user roles.
Example request:
curl -X GET \
'https://harvest.greenhouse.io/v1/user_roles
-H 'Authorization: Basic *******' \
Example response:
[
{
"id": 4730,
"type": "job_admin",
"name": "Standard"
},
{
"id": 4731,
"type": "job_admin",
"name": "Private"
}
]
The user role IDs returned can be used to assign Job Admin permissions for individual jobs via the Harvest API endpoint PUT: Add a Job Admin permission. For assigning future Job Admin permissions by office or department you'd want to use the Harvest API endpoint PUT: Add a Future Job Admin Permission.