Create a resume upload session

Create a resume upload session

Required scopes: people:write

Server-mediated signed upload-session. Returns a single-path, short-lived (≤5 min), one-shot signed Storage upload_url. Upload the PDF or DOCX bytes to that URL with an HTTP PUT, then call the finalize endpoint to attach and parse the resume. Secret keys (ys_sk_*) only.

Example (curl):

curl -X POST https://api.yardstick.team/v1/people/per_abc123/resume_upload_sessions \
  -H 'Authorization: Bearer ys_sk_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"file_name":"resume.pdf","size_bytes":48211,"content_type":"application/pdf"}'

Example (TypeScript):

await fetch(
  "https://api.yardstick.team/v1/people/per_abc123/resume_upload_sessions",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.YS_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      file_name: "resume.pdf",
      size_bytes: 48211,
      content_type: "application/pdf",
    }),
  },
).then((r) => r.json());