Skip to content

Document template · generic.hr.job_description

Job Description

  • Render-verified
  • Informational
  • Version 1.0.0

Internal job description defining the role, reporting line, responsibilities, required and preferred skills, and working conditions. Not an offer or a contract.

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 26 fields:

Field Required Type Description
employer Required object
employer.name Required string
job Required object
job.title Required string
job.department Required string
job.location Required string
job.employment_type Required enum
job.reports_to Required string
job.grade Optional string
job.effective_date Optional date
job.version Optional string
purpose Required string
responsibilities Required array of string
required_skills Required array of string
preferred_skills Optional array of string
qualifications Optional array of string
conditions Required object
conditions.hours_per_week Required number
conditions.salary_range_min Optional number
conditions.salary_range_max Optional number
conditions.benefits Optional array of string
conditions.travel Optional string
conditions.remote_policy Optional string
kpis Optional array of object
kpis[].metric Required string
kpis[].target Required 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_description",
    "data": { ... },
    "options": {"language": "en"}
  }' -o job-description.pdf

Frequently asked questions

What is “Job Description”?

Internal job description defining the role, reporting line, responsibilities, required and preferred skills, and working conditions. Not an offer or a contract. On papii this document is available as template generic.hr.job_description: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Job Description 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 Description 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.