Skip to main content
POST
Record an external assessment result

Authorizations

Authorization
string
header
required

Supabase JWT — Authorization: Bearer <token>.

Body

application/json
position_result_step_id
string<uuid>
required

The external assessment step of the application (position_result_step id).

Minimum string length: 1
Example:

"6a0f2d4e-1c3b-4e5f-8a7b-9c0d1e2f3a4b"

status
enum<string>
required

started, completed (a result), expired (not taken in time) or cancelled.

Available options:
started,
completed,
expired,
cancelled
score
number

Score (completed).

Example:

78

score_max
number

Maximum score.

Required range: x > 0
Example:

100

passed
boolean

Pass / fail as the assessment reports it. Without it the step's pass mark decides it from the score.

result_label
string

Result label, for example a language level.

Maximum string length: 200
Example:

"B2"

report_url
string<uri>

Link to the full report (https).

Maximum string length: 2000
note
string

Note for the recruiter.

Maximum string length: 2000

Response

Result recorded.

The recorded result. The step now waits for the recruiter's decision.

outcome
enum<string>
required

applied, or ignored_final for a cancelled assessment.

Available options:
applied,
duplicate,
ignored_final
status
string

Status of the assessment after the call.

score
number
score_max
number
passed
boolean