---
title: "Change the hiring settings"
method: PATCH
path: "/hiring/settings"
tags: ["hiring"]
---

# Change the hiring settings

`PATCH /hiring/settings`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/hiring/settings`
- Auth: HTTP bearer

Edits the candidate email templates (only {candidate_first_name}, {job_title}, {company}, {sender_name} and {booking_link} fill in), how long a decided application is kept (1 to 60 months), and how long other-roles consent lasts (at most 24 months). A template set to null goes back to Binderwork's default.

## Request body

- object
  - `templates` object
  - `retention_months` integer
  - `other_roles_months` integer
  - `careers_intro` string, nullable
  - `privacy_notice_url` string, uri, nullable

## Response `200`

The result.

- object
  - `templates` object, required
    - `received` object, required
      - `subject` string, required
      - `body` string, required
    - `next_step` object, required
      - `subject` string, required
      - `body` string, required
    - `rejection_applied` object, required
      - `subject` string, required
      - `body` string, required
    - `rejection_interview` object, required
      - `subject` string, required
      - `body` string, required
  - `variables` string[], required
  - `booking_link` string, nullable, required
  - `from` object, required
    - `name` string, required
    - `company` string, required
    - `reply_to` string, required
  - `retention_months` integer, required
  - `other_roles_months` integer, required
  - `careers_intro` string, nullable, required
  - `privacy_notice_url` string, nullable, required
  - `scanner` boolean, required
  - `writer` string, nullable, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)