---
title: "List future job permissions"
method: GET
path: "/v3/future_job_permissions"
tags: ["Future Job Permissions"]
---

# List future job permissions

`GET /v3/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.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `department_ids` integer[]
- `office_ids` integer[]
- `user_ids` integer[]
- `role_ids` integer[]
- `fields` string[]
- `external_department_id` string
- `external_office_id` string

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `department_id` integer, 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_id` integer — Id of the user who will receive the role on matching future jobs. References a `/v3/users` row.
  - `office_id` integer, 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_id` integer — 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.

---

[API](https://skmtc.dev/greenhouse/apis/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)