Scheduling

Unassign an interviewer from an interview session

Unassign an interviewer from an interview session

Required scopes: interview_sessions:write

Deletes the scoped (session, interviewer) assignment row when present. Requires a secret key with interview_sessions:write; publishable keys are denied. Removing an interviewer that is not currently assigned is an idempotent no-op and returns removed: 0. The response recomputes scheduling_ready / scheduling_blocker from the remaining rows and includes user_tasks booleans derived from actual trigger side effects.

Example (curl):

curl -X POST https://api.yardstick.team/v1/interview_sessions/is_abc123/actions/unassign_interviewer \
  -H 'Authorization: Bearer ys_sk_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7c3a…' \
  -d '{"interviewer_user_id":"00000000-0000-0000-0000-000000000000"}'

Example (TypeScript):

await fetch(
  "https://api.yardstick.team/v1/interview_sessions/is_abc123/actions/unassign_interviewer",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.YS_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      interviewer_user_id: "00000000-0000-0000-0000-000000000000",
    }),
  },
).then((r) => r.json());
post/v1/interview_sessions/{interview_session_id}/actions/unassign_interviewer

Request

  • Base URL: https://api.yardstick.team
  • URL: https://api.yardstick.team/v1/interview_sessions/{interview_session_id}/actions/unassign_interviewer
  • Auth: HTTP bearer

Path parameters

interview_session_idstring required

Headers

Idempotency-Keystring

Supported for safe retry. Reuse the same key to receive the cached response without repeating the operation.

X-Request-Idstring

Optional caller-supplied request identifier. Values must match ^[A-Za-z0-9_-]{1,128}$; a valid value is echoed in the response X-Request-Id header, otherwise the API generates one.

Request body

interviewer_user_idstring required

The interviewer to unassign, as the usr_<base32> display id or the raw UUID.

Response

Interviewer unassigned or confirmed absent. The response includes scheduling and user-task side-effect signals.

object'interview_session_interviewer' required
interview_session_idstring required

Display id of the interview session, e.g. is_<base32>.

interviewer_user_idstring required

Raw UUID of the interviewer requested for removal.

removedinteger required

1 when a row was deleted; 0 for an idempotent no-op.

scheduling_readyboolean required

True only when the session has exactly one interviewer.

scheduling_blocker'INTERVIEWER_ASSIGNMENT_REQUIRED' | 'INTERVIEWER_ASSIGNMENT_AMBIGUOUS' nullable required

Scheduling blocker derived from the current interviewer assignment rows.

audit_idstring required

Display id of the audit log row.

event_idstring required

Display id of the API event row.

Changes

No recorded changes to this operation across all 1 revision of this API.