Cover Letters

Create, generate, and render cover letters.

List Cover Letters


GET /v1/cover-letters

Request


curl https://api.laddro.com/v1/cover-letters \
  -H "x-api-key: YOUR_API_KEY"

Response


{
  "data": [
    {
      "id": "cl_abc123",
      "title": "Cover Letter for Acme Corp",
      "createdAt": "2026-05-01T10:00:00Z"
    }
  ]
}

Get Cover Letter


GET /v1/cover-letters/{coverLetterId}

Parameters

Parameter	Type	Location	Description
`coverLetterId`	string	path	Cover letter ID

Response


{
  "data": {
    "id": "cl_abc123",
    "title": "Cover Letter for Acme Corp",
    "content": "Dear Hiring Manager,\n\n...",
    "resumeId": "res_abc123",
    "templateId": "graphite"
  }
}

Create Cover Letter


POST /v1/cover-letters

Create a cover letter manually with your own content.

Request Body

Field	Type	Required	Description
`title`	string	Yes	Cover letter title
`content`	string	Yes	Cover letter body text
`resumeId`	string	No	Associated resume ID

Request


curl https://api.laddro.com/v1/cover-letters \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Cover Letter for Acme Corp",
    "content": "Dear Hiring Manager,\n\nI am writing to..."
  }'

Generate Cover Letter


POST /v1/cover-letters/generate

AI-generated cover letter based on a resume and job description. Supports SSE streaming.

Request Body

Field	Type	Required	Description
`resumeId`	string	Yes	Resume to base the letter on
`jobDescription`	string	Yes	Job description text or URL

Standard Request


curl https://api.laddro.com/v1/cover-letters/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resumeId": "res_abc123",
    "jobDescription": "We are hiring a..."
  }'

Streaming Request


curl https://api.laddro.com/v1/cover-letters/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "resumeId": "res_abc123",
    "jobDescription": "We are hiring a..."
  }'

Errors

Status	Description
`400`	Missing required fields
`401`	Missing or invalid API key
`402`	No credits remaining
`404`	Resume not found

Render Cover Letter to PDF


PUT /v1/cover-letters/{coverLetterId}/render

Parameters

Parameter	Type	Location	Description
`coverLetterId`	string	path	Cover letter ID
`templateId`	string	body	Template to use

Request


curl https://api.laddro.com/v1/cover-letters/cl_abc123/render \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "templateId": "graphite" }' \
  --output cover-letter.pdf

Response

Returns application/pdf binary data.