Validate draft interview plan

Validate draft interview plan

Required scopes: interview_plans:write

Validation is read-only. It returns blockers, warnings, next actions, and the builder web_url deep link when the draft is known, but it does not create write audit/event rows.

Example (curl):

curl -X POST https://api.yardstick.team/v1/interview_plan_drafts/actions/validate_draft \
  -H 'Authorization: Bearer ys_sk_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"action":"interview_plan.validate_draft","resource":{"type":"interview_plan_draft","id":"ipd_…"},"input":{"include_warnings":true}}'

Example (TypeScript):

await fetch("https://api.yardstick.team/v1/interview_plan_drafts/actions/validate_draft", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.YS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    action: "interview_plan.validate_draft",
    resource: { type: "interview_plan_draft", id: "ipd_…" },
    input: { include_warnings: true },
  }),
});