## Stages, application forms and what the caller may do (hr:recruiting:* or named on a posting)

`GET /api/hr/v1/recruiting/bootstrap`

Module: HR · operationId: `getRecruitingBootstrap` · Tag: Recruiting · Auth: access token (`Authorization: Bearer <accessToken>`)

`canManage` is `hr:recruiting:manage`, `canReadAll` `hr:recruiting:read` or more; people named on the access
list of a posting (or heading its org unit) get `onAnyPosting`. `settings` only for `hr:recruiting:manage`.
Everybody else `403`.

### Responses

- **200** Configuration (`application/json`)
- **403** Error (`application/json`)

Fields of the 200 answer:

- `canManage` (boolean): The caller holds hr:recruiting:manage
- `canReadAll` (boolean): The caller sees every posting
- `formTemplates` (array of ApplicationForm): Application form templates
  - `name` (string, required): Name of the form (max length 200)
  - `archived` (boolean): Archived: no longer offered for new data, kept for existing data
  - `createdAt` (string (date-time), read-only): When the application form was created
  - `description` (string): Description of the form (max length 2000)
  - `fields` (array of ApplicationFormField): Questions of the form after the fixed fields
    - `key` (string, required): Lower-case letters, digits, - or _; not a core field (first_name, last_name, email, phone, cover_letter, cv, attachments)
    - `kind` (string, required): Kind of answer (one of `text`, `longtext`, `number`, `date`, `bool`, `select`, `multiselect`, `url`, `file`)
    - `label` (string, required): Question text (max length 300)
    - `help` (string): Help text shown with the question (max length 1000)
    - `options` (array of object): Choices of select and multiselect questions
      - `label` (string): Display text of the choice
      - `value` (string): Stored value of the choice
    - `required` (boolean): An answer is required
  - `id` (string (uuid), read-only): Id of the application form
  - `updatedAt` (string (date-time), read-only): When the application form was last changed
  - `version` (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
- `onAnyPosting` (boolean): The caller is named on the access list of a posting
- `settings` (RecruitingSettings)
  - `career` (CareerSite): The tenant's public careers page on its host (`https://<subdomain>.<tenant host domain>/karriere`). Publishing it needs the tenant's subdomain (HR settings; `400` field `subdomain`) and a recruiting mailbox (`409 no_mailbox`).
    - `color` (string): Accent colour #rrggbb; empty for the default
    - `company` (string): The employer named on the page and in the postings' structured data (max length 200)
    - `enabled` (boolean): The page and the public API answer for the tenant's subdomain
    - `intro` (string): Markdown above the postings (max length 20000)
    - `origins` (array of string): Websites (https://host) that may embed the list of postings
    - `subdomain` (string, read-only): The tenant's subdomain (HR settings), the address of the page; empty while the tenant has none
    - `title` (string): Title of the careers page (max length 200)
    - `url` (string, read-only): The page; empty without a subdomain (or where the platform has no tenant hosts)
  - `consentText` (string): The data-protection consent applicants accept (max length 5000)
  - `consentVersion` (integer, read-only): Version of the consent text; counts its changes
  - `fromName` (string): Sender name and signature of applicant mail (max length 200)
  - `mailboxId` (string): The comms mailbox (consumer recruiting) applicant mail is sent from and answered to; empty: no applicant mail
  - `privacyUrl` (string): https link to the privacy notice
  - `retentionDays` (integer): Rejected, withdrawn and hired applications are deleted this long after they closed (default 183, AGG) (max 3650)
  - `talentPoolMonths` (integer): How long applications of people who agreed to the talent pool are kept (max 60)
  - `updatedAt` (string (date-time), read-only): When the settings were last changed
  - `updatedBy` (string, read-only): Who last changed the settings (e-mail)
  - `version` (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
- `stages` (array of RecruitingStage): Stages of the pipeline
  - `name` (string, required): Name of the stage (max length 100)
  - `phase` (string, required): Phase of the stage; rules look only at the phase (one of `new`, `active`, `hired`, `rejected`, `withdrawn`)
  - `archived` (boolean): Archived: no longer offered, kept for existing applications
  - `id` (string (uuid)): Empty for a new stage
  - `position` (integer, read-only): Position in the pipeline

Example 200 answer:

```json
{
  "canManage": true,
  "canReadAll": true,
  "formTemplates": [
    {
      "archived": false,
      "createdAt": "2026-09-01T09:00:00Z",
      "description": "Zusatzfragen für Stellen in Technik und Service Desk",
      "fields": [
        {
          "key": "fruehester_start",
          "kind": "date",
          "label": "Ab wann können Sie bei uns starten?",
          "required": true
        }
      ],
      "id": "3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90",
      "name": "Technische Stellen",
      "updatedAt": "2026-09-15T13:20:00Z",
      "version": 2
    }
  ],
  "onAnyPosting": true,
  "settings": {
    "consentVersion": 2,
    "fromName": "Muster IT-Systemhaus GmbH – Personal",
    "mailboxId": "5a7c9e1a-3c5e-4a7c-8e1a-3c5e7a9c1e91",
    "privacyUrl": "https://www.muster-it.example/datenschutz",
    "retentionDays": 183,
    "talentPoolMonths": 12,
    "version": 4
  },
  "stages": [
    {
      "archived": false,
      "id": "6c8e0a2c-4e6a-4c8e-8a2c-4e6a8c0e2a82",
      "name": "Eingegangen",
      "phase": "new",
      "position": 1
    },
    {
      "archived": false,
      "id": "8e0a2c4e-6a8c-4e0a-9c4e-6a8c0e2a4c83",
      "name": "In Prüfung",
      "phase": "active",
      "position": 2
    },
    {
      "archived": false,
      "id": "0a2c4e6a-8c0e-4a2c-8e6a-8c0e2a4c6e84",
      "name": "Interview",
      "phase": "active",
      "position": 3
    },
    {
      "archived": false,
      "id": "2c4e6a8c-0e2a-4c4e-9a8c-0e2a4c6e8a85",
      "name": "Angebot",
      "phase": "active",
      "position": 4
    },
    {
      "archived": false,
      "id": "4e6a8c0e-2a4c-4e6a-8c0e-2a4c6e8a0c86",
      "name": "Eingestellt",
      "phase": "hired",
      "position": 5
    },
    {
      "archived": false,
      "id": "6a8c0e2a-4c6e-4a8c-9e2a-4c6e8a0c2e87",
      "name": "Abgesagt",
      "phase": "rejected",
      "position": 6
    },
    {
      "archived": false,
      "id": "8c0e2a4c-6e8a-4c0e-8a4c-6e8a0c2e4a88",
      "name": "Zurückgezogen",
      "phase": "withdrawn",
      "position": 7
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/recruiting/bootstrap' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
