Create future job permission

post

https://harvest.greenhouse.io/v3/future_job_permissions

Grant a user a Job Admin role on future jobs matching an optional department and/or office scope. Pass department_id (or external_department_id) and/or office_id (or external_office_id) to restrict the scope; omit all four to grant the role on every future job in the organization. The role_id must reference a Job Admin organization role. Site admins already have access to every non-confidential job, so creating a future job permission for a site admin is a no-op and returns 204 No Content instead of 201 Created.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

department_id

integer

Id of the department to scope this permission to. Future jobs created in this department (optionally combined with office_id) will grant the user the specified role. Mutually exclusive with external_department_id. Omit both department fields and both office fields to grant the role on every future job in the organization.

external_department_id

string

Partner-supplied external_id of the department to scope this permission to. Resolved to a Greenhouse department_id in the caller's organization; unknown values are rejected. Mutually exclusive with department_id.

user_id

integer

required

Id of the user who should receive the role on matching future jobs. Must reference a user in the caller's organization.

office_id

integer

Id of the office to scope this permission to. Future jobs created in this office (optionally combined with department_id) will grant the user the specified role. Mutually exclusive with external_office_id. Omit both office fields and both department fields to grant the role on every future job in the organization.

external_office_id

string

Partner-supplied external_id of the office to scope this permission to. Resolved to a Greenhouse office_id in the caller's organization; unknown values are rejected. Mutually exclusive with office_id.

role_id

integer

required

Id of the Job Admin organization role to grant on matching future jobs. Must reference a Job Admin role in the caller's organization; other role types are rejected.

Responses

204

Successful (No Content)

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Successful