Job Postings

Validate a draft job posting for publish-readiness

Validate a draft job posting for publish-readiness

Required scopes: job_postings:read

Read-only. Returns blockers describing the fields that would prevent publishing; does not mutate the posting.

Example (curl):

curl -X POST https://api.yardstick.team/v1/job_postings/jp_abc123/actions/validate_draft \
  -H 'Authorization: Bearer ys_sk_live_…'

Example (TypeScript):

await fetch(
  "https://api.yardstick.team/v1/job_postings/jp_abc123/actions/validate_draft",
  {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.YS_API_KEY}` },
  },
).then((r) => r.json());
post/v1/job_postings/{job_posting_id}/actions/validate_draft

Request

  • Base URL: https://api.yardstick.team
  • URL: https://api.yardstick.team/v1/job_postings/{job_posting_id}/actions/validate_draft
  • Auth: HTTP bearer

Path parameters

job_posting_idstring required

Headers

Idempotency-Keystring

Supported for safe retry. Reuse the same key to receive the cached response without repeating the operation.

X-Request-Idstring

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

object'validation_result' required
validation_passedboolean required
posting_idstring required

Display id, e.g. jp_<base32>

Changes

No recorded changes to this operation across all 2 revisions of this API.