Cartas de presentacion
Crear, generar y renderizar cartas de presentacion.
curl https://api.laddro.com/v1/cover-letters \
-H "x-api-key: YOUR_API_KEY"
{
"data": [
{
"id": "cl_abc123",
"title": "Cover Letter for Acme Corp",
"createdAt": "2026-05-01T10:00:00Z"
}
]
}
GET /v1/cover-letters/{coverLetterId}
| Parametro | Tipo | Ubicacion | Descripcion |
|---|
coverLetterId | string | path | ID de la carta de presentacion |
{
"data": {
"id": "cl_abc123",
"title": "Cover Letter for Acme Corp",
"content": "Dear Hiring Manager,\n\n...",
"resumeId": "res_abc123",
"templateId": "graphite"
}
}
Crea una carta de presentacion manualmente con tu propio contenido.
| Campo | Tipo | Requerido | Descripcion |
|---|
title | string | Si | Titulo de la carta de presentacion |
content | string | Si | Texto del cuerpo de la carta |
resumeId | string | No | ID del curriculo asociado |
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..."
}'
POST /v1/cover-letters/generate
Carta de presentacion generada por IA basada en un curriculo y una descripcion de empleo. Soporta streaming SSE.
| Campo | Tipo | Requerido | Descripcion |
|---|
resumeId | string | Si | Curriculo en el que se basa la carta |
jobDescription | string | Si | Texto o URL de la descripcion del empleo |
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..."
}'
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..."
}'
| Estado | Descripcion |
|---|
400 | Campos requeridos faltantes |
401 | Clave API faltante o invalida |
402 | Sin creditos disponibles |
404 | Curriculo no encontrado |
PUT /v1/cover-letters/{coverLetterId}/render
| Parametro | Tipo | Ubicacion | Descripcion |
|---|
coverLetterId | string | path | ID de la carta de presentacion |
templateId | string | body | Plantilla a utilizar |
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
Devuelve datos binarios application/pdf.
