Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
User Job Permissions

List user job permissions

User job permissions are the per-user, per-job access grants that pair a user with a Job Admin role on a specific job. Each row represents one (user_id, job_id, role_id) assignment; a user with access to multiple jobs appears in multiple rows. Site admins are not represented here — they have implicit access to every non-confidential job — so this endpoint only lists Job Admin grants. Filter with user_ids, job_ids, or role_ids to narrow the result set; combine with /v3/future_job_permissions (scope-based grants applied when matching jobs are later created) for the full picture of a user's job access.

get/v3/user_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
job_idsinteger[]

Return only user job permission rows for these job (hiring plan) ids.

user_idsinteger[]

Return only user job permission rows for these Greenhouse user ids (the users being granted job-specific permissions).

role_idsinteger[]

Return only user job permission rows for these permission role ids (e.g., admin, recruiter, hiring manager).

fieldsstring[]

Comma separated list of fields to return

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
job_idinteger

Id of the job this permission grants the user access to. References a /v3/jobs row.

user_idinteger

Id of the user receiving access to the job. References a /v3/users row. Site admins are never represented here — they have implicit access to every non-confidential job — so a user with a site admin role will not appear in this list.

role_idinteger

Id of the Job Admin role the user holds on this job. References a /v3/user_roles row; only roles with role_type: job_admin can be granted through this resource.

automatedboolean nullable

When true, the permission was created by an automated permission rule (e.g. a future_job_permission that matched the job when it was opened, or an automated permission policy) rather than assigned by hand.