Cancel a final round
Cancels the report's final round: interviewers stop seeing it and the record stays, with status cancelled. Announced as final_round.cancelled. Cancelling a cancelled final round changes nothing. Answers final_round_not_found when none was prepared. PUT prepares it afresh.
Required scope: reports:write.
Errors
- 400:
unknown_field - 401:
authentication_required,invalid_api_key - 403:
api_access_disabled,insufficient_scope,permission_denied - 404:
final_round_not_found,report_not_found - 409:
final_round_completed - 422:
invalid_parameter - 429:
rate_limit_exceeded - 500:
api_error - 503:
maintenance_mode,service_unavailable
ApiKeyAuthorizationBearer <probb_live_<id>_<secret>>id*stringThe report's ID.
1 <= length <= 200Success.
application/json- response
object*stringid*stringThe final round's ID.
reportId*stringThe report it was prepared from. A report has at most one.
candidate*The candidate being interviewed.
job*The job.
status*stringactive, completed or cancelled.
"active""completed""cancelled"locked*booleanTrue once an interviewer has submitted a scorecard. A locked final round can no longer be changed.
items*array<|>What the panel will cover, in order: the requirements chosen, then the members' own questions.
interviewers*array<>Who asks what. Every item has exactly one interviewer, a member or an outside interviewer.
preparedBy*|Who prepared it, or null if that person was since deleted.
completedAt*|When every interviewer still in the organisation had submitted a scorecard, or null while the panel is still working.
createdAt*stringdate-timeupdatedAt*stringdate-time# Set PROBB_URL and PROBB_API_KEY. Replace any *_VALUE placeholder and any example ID (such as job_example) with a real one.curl --fail-with-body -X DELETE "$PROBB_URL/api/v1/reports/ID_VALUE/final-round" \ -H "Authorization: Bearer $PROBB_API_KEY"{ "object": "final_round", "id": "string", "reportId": "string", "candidate": { "id": "string", "name": "string" }, "job": { "id": "string", "title": "string" }, "status": "active", "locked": true, "items": [ { "kind": "requirement", "key": "string", "label": "string", "priority": "must_have", "hardConstraint": true, "resume": { "state": "shown", "summary": "string" }, "interview": { "state": "shown", "summary": "string" }, "followUpRecommended": true, "guidance": "string", "probes": [ "string" ] } ], "interviewers": [ { "assignmentId": "string", "kind": "member", "user": { "id": "string", "name": "string" }, "external": { "emailMasked": "string", "link": "queued", "linkExpiresAt": "2019-08-24T14:15:22Z" }, "itemKeys": [ "string" ] } ], "preparedBy": { "id": "string", "name": "string" }, "completedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}