GRgreenhouse
User Job Permissions

Bulk create user job permissions

Asynchronously grant Job Admin roles on specific jobs to many users in a single call. Each item follows the same shape as POST /v3/user_job_permissions, with job_id, user_id, and role_id required, and is processed independently. A bulk_action_uuid is returned immediately. Per-item success or failure is reported through GET /v3/bulk_requests/{bulk_action_uuid}. Items whose user_id references a site admin create no permission row and are reported as successful with an empty result, since site admins already have access to every non-confidential job.

post/v3/user_job_permissions/bulk

Request

  • Base URL
    https://harvest.greenhouse.io
  • URL
    https://harvest.greenhouse.io/v3/user_job_permissions/bulk
  • Auth
    OAuth 2
    Authorization code: https://auth.greenhouse.io/authorize
    Client credentials
    Token URL: https://auth.greenhouse.io/token scopes: harvest:user_job_permissions:create

Request body

callback_urlstring

Optional HTTPS URL Greenhouse will POST to when every row in data has finished. Omit to poll GET /v3/bulk_requests/{bulk_action_uuid} instead.

Response

Accepted

bulk_action_uuidstring

UUID assigned to the new bulk request. Use this with GET /v3/bulk_requests/{bulk_action_uuid} to monitor progress and retrieve per-row results.

statusstring

Initial lifecycle state of the new bulk request, typically building immediately after creation. See the bulk request response schema for the full set of values.

status_urlstring

Relative path that returns the current status of the bulk request. Append this to your Harvest base URL to fetch the latest state.

Changes

No recorded changes to this operation across all 1 revision of this API.