---
title: "Update Exam Pdf Options Route"
method: PUT
path: "/teacher-exams/{exam_id}/latex/pdf-options"
tags: ["Teacher Exams LaTeX"]
---

# Update Exam Pdf Options Route

`PUT /teacher-exams/{exam_id}/latex/pdf-options`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/teacher-exams/{exam_id}/latex/pdf-options`
- Auth: OAuth 2 (password, token URL `api/login`)

Update PDF formatting options for a specific exam and automatically save as teacher preferences.

Note: Teacher global preferences are only updated if the teacher is the actual owner of the exam,
not when accessing a shared exam. This prevents contamination of personal preferences with shared exam settings.

A finished school year does not close this one: the layout describes the
printout the teacher is making today, not what the class was given that
year. The sujet, the corrigé, the titre and the niveau stay frozen.

## Path parameters

- `exam_id` string, required

## Request body

- PDFOptionsUpdate
  - `teacher_name` string, nullable
  - `date` string, nullable
  - `school_logo_url` string, nullable
  - `class_name` string, nullable
  - `title_override` string, nullable
  - `duration` string, nullable
  - `general_instructions` string, nullable
  - `template` string, nullable
  - `font_family` string, nullable
  - `font_size` number, nullable
  - `line_spacing` number, nullable
  - `include_header` boolean, nullable
  - `number_exercises` boolean, nullable
  - `auto_save_preferences` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-21** `1d6009058248`: 1 info
  - api operation id `update_exam_pdf_options_teacher_exams__exam_id__latex_pdf_options_put` removed and replaced with `update_exam_pdf_options_route_teacher_exams__exam_id__latex_pdf_options_put`
- **2026-09-20** `294412cdd7e2`: 1 info
  - added the new optional request property `number_exercises`

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/teacher-exams/:exam_id/latex/pdf-options/put.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)