Create a draft job posting

Create a draft job posting

Required scopes: job_postings:write

The interview plan must already be attached to a Job. An unattached plan is rejected with HTTP 409 interview_plan_not_linked_to_job; attach it first via POST /v1/jobs/{job_id}/actions/attach_artifact with artifact_type=interview_plan.

Example (curl):

curl -X POST https://api.yardstick.team/v1/job_postings \
  -H 'Authorization: Bearer ys_sk_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7c3a…' \
  -d '{"title":"Account Executive","interview_plan_id":"ipd_…","slug":"account-executive"}'

Example (TypeScript):

await fetch("https://api.yardstick.team/v1/job_postings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.YS_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    title: "Account Executive",
    interview_plan_id: "ipd_…",
    slug: "account-executive",
  }),
});