Skip to content
Vektorprogrammet

Recruitment

Applicant assignment, interview scheduling, conduct, and invitation response.

Read assignment board

GET/api/recruitment/application-assignments

Returns applicants and interviewers where the caller manages interviews.

Query Parameters

statusRequired
string
Values
newall

Responses

Assign applicant

POST/api/recruitment/applications/{applicationId}/interviews

Assigns an applicant to an eligible interviewer.

Path Parameters

applicationIdRequired
string

Header Parameters

idempotency-keyRequired
string

Request Body

application/json
interviewerPersonIdRequired
string
interviewSchemaIdRequired
string

Responses

Read completed interview report

GET/api/recruitment/interview-report

Returns limited completed interview observations for an explicitly selected department admission period; proven self assessments are excluded.

Query Parameters

admissionPeriodId
string·min 1
recommendation
string
Values
allJaKanskjeNeinot-recorded
participation
string
Values
allReturningUnknown
sort
string
Values
applicantrecommendationtotal
direction
string
Values
ascdesc

Responses

Read interview staffing

GET/api/recruitment/interview-staffing

Returns interviews, eligible candidates, and staffing history in the current coordinator scope.

Responses

Read scheduling board

GET/api/recruitment/interviews

Returns interviews visible to the current member.

Responses

Read interview conduct

GET/api/recruitment/interviews/{interviewId}

Returns interview questions and conduct state.

Path Parameters

interviewIdRequired
string

Header Parameters

if-match
string
if-none-match
string

Responses

Cancel interview

POST/api/recruitment/interviews/{interviewId}:cancel

Cancels an interview before finalization.

Path Parameters

interviewIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Correct interview assessment

POST/api/recruitment/interviews/{interviewId}:correct

Appends a replacement assessment to a completed interview.

Path Parameters

interviewIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json
answersRequired
object[]

expectedRevisionRequired
integer·min 0
recommendationRequired
string
Values
JaKanskjeNei
scoreRequired
object

Responses

Finalize interview

POST/api/recruitment/interviews/{interviewId}:finalize

Records answers and scores for an interview.

Path Parameters

interviewIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json
answersRequired
object[]

recommendationRequired
string
Values
JaKanskjeNei
scoreRequired
object

Responses

Schedule interview

POST/api/recruitment/interviews/{interviewId}:schedule

Schedules an assigned interview and invitation.

Path Parameters

interviewIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json
campusRequired
string·max 250
mapLinkRequired
string
messageRequired
string·max 2000
roomRequired
string·max 250
scheduledAtRequired
string

Responses

Read invitation response

GET/api/recruitment/invitation-response

Reads an interview invitation by capability.

Header Parameters

if-match
string
if-none-match
string

Responses

Confirm invitation

POST/api/recruitment/invitation-response:confirm

Accepts an interview invitation by capability.

Header Parameters

if-matchRequired
string

Request Body

application/json

Responses

Reject invitation

POST/api/recruitment/invitation-response:reject

Rejects an interview invitation by capability.

Header Parameters

if-matchRequired
string

Request Body

application/json
message
string

Responses

Request a new invitation time

POST/api/recruitment/invitation-response:request-new-time

Requests another interview time by capability.

Header Parameters

if-matchRequired
string

Request Body

application/json
messageRequired
string

Responses

Maintain recruitment

POST/api/recruitment/maintenance/commands

Creates or revises a questionnaire, or replaces a nonterminal interview staffing pair with an observed revision and reason.

Header Parameters

idempotency-keyRequired
string

Request Body

application/json

Responses

Read questionnaires

GET/api/recruitment/questionnaires

Returns global questionnaire definitions and immutable maintenance history for a current global administrator.

Responses