Skip to content
Vektorprogrammet

Volunteer placement

Explicit affiliation, placement, confirmed roster, dated school commitment, absence, coverage records, and immutable outcomes.

Read placement board

GET/api/placements

Only holders of placement coordination in the department (a board leadership or a delegation) or global administrators.

Query Parameters

departmentIdRequired
string
semesterIdRequired
string

Responses

Manage placement and dated school service

POST/api/placements

Commands keep demand, proposals, commitments, and placement changes inside one transaction.

Query Parameters

departmentIdRequired
string
semesterIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Read own affiliation

GET/api/placements/affiliation

Authenticated Person only; no person selector.

Query Parameters

departmentIdRequired
string

Responses

Request or withdraw own affiliation

POST/api/placements/affiliation

Self nomination gives scoped coordinators permission to discover this person.

Query Parameters

departmentIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json
actionRequired
string
Values
RequestWithdraw

Responses

Read coordinator coverage board

GET/api/placements/coverage

Only a scoped coordinator can read absences, coverage records, possible coverers, per-absence closures, and commitment outcomes.

Query Parameters

departmentIdRequired
string
semesterIdRequired
string

Responses

Record coverage and decide dated service

POST/api/placements/coverage

Commands check coordinator scope, record absences and coverage, and derive actual attendance for immutable outcome evidence inside one transaction.

Query Parameters

departmentIdRequired
string
semesterIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Read own coverage and scheduled service

GET/api/placements/coverage/own

A person sees only commitments where they are scheduled or cover a recorded absence, and names of possible coverers only while they have an open absence.

Query Parameters

departmentIdRequired
string
semesterIdRequired
string

Responses

Report own absence or record who covers it

POST/api/placements/coverage/own

The current person must own a scheduled assignment in an open commitment; coverage commands name only that person's own absence.

Query Parameters

departmentIdRequired
string
semesterIdRequired
string

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Draft placements

GET/api/placements/draft

Drafts open school demand for unplaced active assistants from their weekday availability and teaching blocks. Nothing is stored; coordinators apply the draft with placement commands.

Query Parameters

departmentIdRequired
string
semesterIdRequired
string

Responses

Select placement department and semester

GET/api/placements/scopes

Public department labels and canonical semesters; private candidate names require coordinator authority.

Responses