Alfa

Jobs

Change a job's screening criteria, and optionally re-screen its applicants

PATCH/v1/jobs/{jobId}/screening

Works at any job status. Send the `etag` of the criteria you loaded as `If-Match`: the save fails with 412 when they changed since, and the response carries the new `etag`. `expectedSkills` is the older guard on the skills alone and is deprecated. The ids of the applicants queued for re-screening are returned.

Requires the session token of a signed-in Alfa user as a bearer token.

Path parameters

  • jobIdinteger | stringrequired

Headers

  • If-Matchstring

    The `etag` you read. The write applies only if the resource still has it; otherwise it fails with 412 and changes nothing.

Request body

  • skillsstring | object[]
  • hard_filtersobject | null
  • screening_listsobject

    The screening lists

  • expectedSkillsstring | object[]
  • rescreenboolean

Responses

  • 200Success.
  • 400The request is malformed: invalid JSON, an unexpected body or an unknown query parameter. Problem details
  • 401The bearer token is missing, expired or invalid. Problem details
  • 403The caller may not perform this operation, or has no active organisation. Problem details
  • 404The resource does not exist or is not visible to the caller. Problem details
  • 412The resource changed since the entity tag sent as `If-Match` was read. Read it again, then repeat the change. Problem details
  • 422The request failed validation; `errors` lists each invalid field. Problem details
  • 429Too many requests, or the AI service is busy. Retry after a short wait. Problem details
  • 500An unexpected error. Quote the `correlationId` to support. Problem details