# Write the application's cover letter

Writes a cover letter of about 250 words for the application, from the resume it sends (the tailored copy when it sends that) and the posting, and keeps it on the application in place of any earlier one. Tone is one of neutral, warm, formal, concise. It never states an employer, skill, number or claim about the company that the resume or posting does not; a letter that does is written again once, and refused if it still does. Requires a reviewed posting. Counts one AI action. Requires authentication.

```http
POST https://hiresweep.com/api/openapi/applications/{id}/cover-letter
x-api-key: YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes |  |

## Request body

```json
{
  "type": "object",
  "properties": {
    "tone": {
      "enum": [
        "neutral",
        "warm",
        "formal",
        "concise"
      ],
      "type": "string",
      "default": "neutral",
      "description": "How the letter reads."
    }
  }
}
```

## Responses

- `200`: The application with its new cover letter.
- `502`: 502