Skip to main content
PATCH
Update a cover letter

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
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
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}$