Laddro DocsLaddro Docs

Lettres de motivation

Lettres de motivation

Creer, generer et rendre des lettres de motivation.

Lister les lettres de motivation

GET /v1/cover-letters

Requete

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

Reponse

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

Obtenir une lettre de motivation

GET /v1/cover-letters/{coverLetterId}

Parametres

ParametreTypeEmplacementDescription
coverLetterIdstringpathID de la lettre de motivation

Reponse

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

Creer une lettre de motivation

POST /v1/cover-letters

Creez une lettre de motivation manuellement avec votre propre contenu.

Corps de la requete

ChampTypeRequisDescription
titlestringOuiTitre de la lettre de motivation
contentstringOuiTexte du corps de la lettre
resumeIdstringNonID du CV associe

Requete

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..."
  }'

Generer une lettre de motivation

POST /v1/cover-letters/generate

Lettre de motivation generee par IA basee sur un CV et une description de poste. Supporte le streaming SSE.

Corps de la requete

ChampTypeRequisDescription
resumeIdstringOuiCV sur lequel baser la lettre
jobDescriptionstringOuiTexte ou URL de la description du poste

Requete standard

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..."
  }'

Requete avec streaming

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..."
  }'

Erreurs

StatutDescription
400Champs requis manquants
401Cle API manquante ou invalide
402Plus de credits disponibles
404CV non trouve

Rendre une lettre de motivation en PDF

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

Parametres

ParametreTypeEmplacementDescription
coverLetterIdstringpathID de la lettre de motivation
templateIdstringbodyModele a utiliser

Requete

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

Reponse

Retourne des donnees binaires application/pdf.

On this page