Answer an assigned review task

Required scopes: tasks:write

Uses the same response functions as the dashboard. Application reviews accept approve (moves to Candidates), reject, hold, or ask_recruiter. Scorecard reviews accept thumbs_up, thumbs_down, or note_to_recruiter. Recruiter-note responses require a nonempty note. Only the assigned reviewer with active organization membership may answer an open review. Closed reviews return 409; unsupported task kinds or answers return 400; an unassigned reviewer receives 403.

Example (curl):

curl https://api.yardstick.team/v1/tasks/tsk_abc123/actions/respond -X POST -H 'Authorization: Bearer ys_sk_live_…' -H 'Content-Type: application/json' -d '{"decision":"approve"}'

Example (TypeScript):

await fetch("https://api.yardstick.team/v1/tasks/tsk_abc123/actions/respond", { method: "POST", headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ decision: "approve" }) });