Apply a candidate status-change email decision

Required scopes: applications:write, applications:transition_status, communications:write

Secret keys only. Applies the Application status transition and records the candidate email decision intent. Use Idempotency-Key for retries; replaying the same key with the same decision returns the prior result. send_now additionally requires communications:send and is rejected for approval-required communications.

Example (curl):

curl -X POST https://api.yardstick.team/v1/applications/app_abc123/email-decision/apply \
  -H 'Authorization: Bearer ys_sk_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7c3a…' \
  -d '{"status":"Interviewing","decision":"review_edit"}'

Example (TypeScript):

await fetch("https://api.yardstick.team/v1/applications/app_abc123/email-decision/apply", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.YS_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({ status: "Interviewing", decision: "review_edit" }),
}).then((r) => r.json());