Skip to content

Document template · generic.hr.job_posting

Job Posting

  • Render-verified
  • Informational
  • Version 1.0.0

External-facing job advertisement: company blurb, role summary, responsibilities, candidate profile, what's on offer, and how to apply.

JSON Schema

Fields in this template

Data sent to the API is validated against the template’s JSON Schema before anything is rendered. This template defines 24 fields:

Field Required Type Description
company Required object
company.name Required string
company.about Required string
job Required object
job.title Required string
job.location Required string
job.employment_type Required string
job.contract_duration Optional string
role_summary Required string
what_youll_do Required array of string
what_we_look_for Required array of string
nice_to_have Optional array of string
what_we_offer Required array of string
compensation Optional object
compensation.salary_min Optional number
compensation.salary_max Optional number
compensation.notes Optional string
application Required object
application.email Optional string
application.url Optional string
application.reference Optional string
application.closing_date Optional date
application.contact_name Optional string
application.documents_requested Optional array of string

POST /render

Generate it

One POST /render call: send your JSON, get the finished PDF back. Or skip the JSON entirely and describe the document in plain language on chut.app.

curl
curl -X POST https://api.papii.eu/render \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "generic.hr.job_posting",
    "data": { ... },
    "options": {"language": "en"}
  }' -o job-posting.pdf

Frequently asked questions

What is “Job Posting”?

External-facing job advertisement: company blurb, role summary, responsibilities, candidate profile, what's on offer, and how to apply. On papii this document is available as template generic.hr.job_posting: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Job Posting with AI?

Yes. chut.app — the AI back office papii powers — fills this template from a plain-language description: you describe the document in one sentence, the AI structures the data, papii validates it against the schema and renders the PDF. Developers can also call the papii API directly with structured JSON.

Is the Job Posting template legally compliant?

This template is render-verified: its schema, sample data and PDF output are automatically tested on every release. It is published with status “ready”, meaning it has not yet been through papii’s final legal review. Where it references specific legislation, that is stated in the template description — always have a professional check documents with legal effect before relying on them.