Skip to content
papii

Document template · generic.hr.promotion_letter

Promotion Letter

  • Render-verified
  • Legal-sensitive
  • Version 1.0.0

Formal addendum to an existing employment contract confirming a promotion: new title, reporting line, grade, responsibilities and updated compensation, effective from a stated date.

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

Field Required Type Description
employer Required object
employer.name Required string
employer.address Required string
employer.reference Optional string
employee Required object
employee.name Required string
employee.address Required string
letter_date Required date
effective_date Required date
previous_role Required object
previous_role.title Required string
previous_role.department Required string
previous_role.reports_to Required string
previous_role.grade Optional string
new_role Required object
new_role.title Required string
new_role.department Required string
new_role.reports_to Required string
new_role.grade Optional string
new_role.responsibilities Required array of string
compensation Required object
compensation.previous_gross Required number
compensation.new_gross Required number
compensation.salary_period Required string
compensation.bonus_target_previous_pct Optional number
compensation.bonus_target_new_pct Optional number
compensation.new_benefits Optional array of string
reason_for_promotion Optional string
signatory Required object
signatory.name Required string

+1 more fields — the full JSON Schema is available in the dashboard and via the API.

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.promotion_letter",
    "data": { ... },
    "options": {"language": "en"}
  }' -o promotion-letter.pdf
Generate with AI on chut.app Try in the dashboard

Frequently asked questions

What is “Promotion Letter”?

Formal addendum to an existing employment contract confirming a promotion: new title, reporting line, grade, responsibilities and updated compensation, effective from a stated date. On papii this document is available as template generic.hr.promotion_letter: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Promotion Letter 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 Promotion Letter 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.