Skip to main content
PATCH
/
v1
/
cover-letter
/
{id}
Update Cover Letter
curl --request PATCH \
  --url https://api.mokaru.ai/v1/cover-letter/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "content": "<string>",
  "templateId": "<string>",
  "isDefault": true,
  "variables": {},
  "showName": true,
  "showEmail": true,
  "showPhone": true,
  "showAddress": true,
  "headerAlignment": "<string>",
  "fontFamily": "<string>",
  "fontSize": 123,
  "lineSpacing": 123
}
'
{
  "success": true,
  "id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Update any field on a cover letter. Only fields you include in the request are modified.
Plus plan only. Returns 403 with { requiresUpgrade: true } if the user is on the free plan.
Scope required: cover-letter:write | Rate limit: 20 requests/min

​
Request

PATCH /v1/cover-letter/{id}

​
Body Parameters

All fields are optional. At least one must be provided.
​
title
string
Cover letter title.
​
content
string
Body text.
​
templateId
string
Cover letter template id. Pass null to clear.
​
isDefault
boolean
Promote to default cover letter (unsets any existing default).
​
variables
object
Template-variable map. Pass null to clear all variables.
​
showName
boolean
Header: show name.
​
showEmail
boolean
Header: show email.
​
showPhone
boolean
Header: show phone.
​
showAddress
boolean
Header: show address.
​
headerAlignment
string
left | center | right.
​
fontFamily
string
Font family.
​
fontSize
number
Font size in pt.
​
lineSpacing
number
Line spacing.

​
Example

curl -X PATCH "https://api.mokaru.ai/v1/cover-letter/clx_cl_abc" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "variables": { "company": "Stripe", "contactPerson": "John Smith" } }'

​
Response

​
success
boolean
Whether the update succeeded.
​
id
string
The cover letter ID.
{ "success": true, "id": "clx_cl_abc" }