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());
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
Headers
Supported for safe retry. Reuse the same key to receive the cached response without repeating the operation.
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
Response
Interviewer unassigned or confirmed absent. The response includes scheduling and user-task side-effect signals.
Changes
No recorded changes to this operation across all 1 revision of this API.