Skip to main content
PATCH
cURL

Authorizations

x-api-key
string
header
required

The API key to authenticate requests.

Path Parameters

id
string
required
Minimum string length: 1

Body

application/json
expectedRevision
integer
required
Required range: 1 <= x <= 9007199254740991
name
string
Required string length: 1 - 100
recipient
string
Maximum string length: 20000
content
string
Maximum string length: 100000
greeting
string | null
Maximum string length: 2000
signOff
string | null
Maximum string length: 2000
template
enum<string>

Sets the letter's own template, which unlinks its design.

Available options:
azurill,
bronzor,
chikorita,
ditgar,
ditto,
gengar,
glalie,
kakuna,
lapras,
leafish,
meowth,
onyx,
pikachu,
porygon,
rhyhorn,
scizor,
smeargle
metadata
object

Sets the letter's own type, colors and page settings, which unlinks its design.

recipientName
string
Maximum string length: 200
recipientCompany
string
Maximum string length: 200
letterDate
string | null
Pattern: ^\d{4}-\d{2}-\d{2}$
resumeId
string | null

The resume the letter goes with.

Minimum string length: 1
applicationId
string | null

The job the letter is for.

Minimum string length: 1
senderLinked
boolean

Take the sender's details live from the resume.

designLinked
boolean

Take the design live from the resume.

sessionId
string

The editing session; its saves share one History version, refreshed every two minutes.

Required string length: 1 - 64

Response

The updated cover letter.

name
string
required
Required string length: 1 - 100
recipient
string
required
Maximum string length: 20000
content
string
required
Maximum string length: 100000
style
object
required
id
string
required
sourceResumeId
string | null
required
sourceApplicationId
string | null
required
senderLinked
boolean
required

The sender's details come live from the source resume, instead of the copy in style.

designLinked
boolean
required

The design comes live from the source resume, instead of the copy in style.

isLocked
boolean
required

Locked letters can't be edited or moved to Trash until they're unlocked.

revision
integer
required
Required range: 1 <= x <= 9007199254740991
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
greeting
string | null

Custom greeting; null uses the document language default, empty omits it.

Maximum string length: 2000
signOff
string | null

Custom signature including name and optional contact details; null uses the document language default with the sender's name, empty omits it.

Maximum string length: 2000
layout
enum<string>
default:freeform

structured: recipient name, company and date fields, a greeting from the name, the body and a sign-off. freeform: the recipient block and body as written (letters from before structured letters).

Available options:
structured,
freeform
recipientName
string
default:""

Who the letter is to: a person, or a team.

Maximum string length: 200
recipientCompany
string
default:""
Maximum string length: 200
letterDate
string | null

The letter's date, as YYYY-MM-DD.

Pattern: ^\d{4}-\d{2}-\d{2}$