Decide a hiring manager step

Decide a hiring manager step

Required scopes: tasks:write, applications:read

Records or changes the hiring manager decision on the candidate's latest step that waits on the hiring manager. advance moves the candidate on; hold keeps them where they are. The job's hiring manager or a recruiter on the job may decide; anyone else gets 403 application_decision_forbidden. Pass interview_id to name the step; without it the latest waiting step is used. send_to_recruiter: true also sends the note to the recruiter. The response is the decision read shape after the write.

Example (curl):

curl -X POST https://api.yardstick.team/v1/applications/app_def456/actions/decide_hiring_step \
  -H 'Authorization: Bearer ys_sk_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7c3a…' \
  -d '{"decision":"advance","note":"Strong systems depth"}'

Example (TypeScript):

await fetch(
  "https://api.yardstick.team/v1/applications/app_def456/actions/decide_hiring_step",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.YS_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({ decision: "advance", note: "Strong systems depth" }),
  },
);