## Confirm an application with the token of the mail's link (public)

`POST /api/hr/v1/careers/confirm`

Module: HR · operationId: `confirmCareerApplication` · Tag: Careers · Auth: none

The link of the confirmation mail points to the tenant's careers page (`https://<subdomain>.<tenant host domain>/karriere/bestaetigen#t=<token>`); the page sends the token here when the applicant presses the button (never on opening – mail scanners open links). Confirming twice answers the same; `duplicate` means an open application of the address to the posting exists already. Unknown and expired tokens answer `404`.

### Request body

`application/json` (required)

- `token` (string, required): Token of the confirmation link (max length 200)

Example:

```json
{
  "token": "EXAMPLE-confirmation-token-4f9a2c"
}
```

### Responses

- **200** The application (`application/json`)
- **400** Error (`application/json`)
- **404** Error (`application/json`)
- **429** Error (`application/json`)

Fields of the 200 answer:

- `postingNumber` (integer): Number of the posting
- `postingTitle` (string): Title of the posting
- `status` (string): confirmed, or duplicate when an open application to the posting exists already (one of `confirmed`, `duplicate`)

Example 200 answer:

```json
{
  "postingNumber": 1,
  "postingTitle": "Systemadministrator:in (m/w/d) Microsoft 365",
  "status": "confirmed"
}
```

### Example request

```bash
curl -X POST 'https://api.mbcom.cloud/api/hr/v1/careers/confirm' \
  -H 'Content-Type: application/json' \
  --data '{"token":"EXAMPLE-confirmation-token-4f9a2c"}'
```
