v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Future Job Permissions

List future job permissions

Future job permissions grant a user a Job Admin role on jobs that don't exist yet — when a new job is created in the matching department and/or office, the permission automatically assigns the user that role on the job. Each row represents one user/role/scope combination; a user with multiple scoped permissions appears in multiple rows. When both department_id and office_id are null, the permission applies to every future job in the organization. Filter with user_ids, role_ids, department_ids, or office_ids to narrow the result set; use external_department_id or external_office_id to filter by partner-supplied scope identifiers without an extra id lookup.

get/v3/future_job_permissions

Query parameters

cursorstring

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
department_idsinteger[]

Return only future job permissions scoped to these department ids (future jobs in these departments will be accessible to the granted user).

office_idsinteger[]

Return only future job permissions scoped to these office ids (future jobs in these offices will be accessible to the granted user).

user_idsinteger[]

Return only future job permissions granted to these Greenhouse user ids.

role_idsinteger[]

Return only future job permissions assigning these permission role ids (maps to organization_role_id).

fieldsstring[]

Comma separated list of fields to return

external_department_idstring

Return only future job permissions scoped to the department with this partner-supplied external_id. Resolved against departments in the caller's organization; unknown values match no records.

external_office_idstring

Return only future job permissions scoped to the office with this partner-supplied external_id. Resolved against offices in the caller's organization; unknown values match no records.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
department_idinteger nullable

Id of the department this permission is scoped to. References a /v3/departments row. When both department_id and office_id are null, the permission applies to every future job in the organization; when set, only future jobs in this department (optionally combined with office_id) grant the role.

user_idinteger

Id of the user who will receive the role on matching future jobs. References a /v3/users row.

office_idinteger nullable

Id of the office this permission is scoped to. References a /v3/offices row. When both office_id and department_id are null, the permission applies to every future job in the organization; when set, only future jobs in this office (optionally combined with department_id) grant the role.

role_idinteger

Id of the Job Admin organization role the user will be assigned on matching future jobs. References a /v3/organization_roles row; future job permissions can only be granted for Job Admin roles.