List interview plan drafts
List interview plan drafts
Required scopes: interview_plans:read
Read-only. Returns in-progress builder drafts in the token organization, newest first, partitioned by the token live/test mode. Drafts are organization-scoped and are deliberately NOT department-scoped: they carry no department, so every reader in the organization sees all of them. Pass job_id to return only the drafts seeded from one Source Job.
Example (curl):
curl 'https://api.yardstick.team/v1/interview_plan_drafts?limit=20' \
-H 'Authorization: Bearer ys_sk_live_…'
Example (TypeScript):
await fetch("https://api.yardstick.team/v1/interview_plan_drafts?limit=20", {
headers: { Authorization: `Bearer ${process.env.YS_API_KEY}` },
}).then((r) => r.json());
Request
- Base URL: https://api.yardstick.team
- URL: https://api.yardstick.team/v1/interview_plan_drafts
- Auth: HTTP bearer
Query parameters
Page size (1-100, default 20).
Cursor: id of the last record from the previous page.
Return only drafts linked to this Job, as a job_... display id. A well-formed id that matches nothing returns an empty list; a malformed one returns 400.
Headers
Optional caller-supplied request identifier. Values must match ^[A-Za-z0-9_-]{1,128}$; a valid value is echoed in the response X-Request-Id header, otherwise the API generates one.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.