Regenerate Cover Letter
regenerate_cover_letterRegenerate an existing cover letter with optional feedback. Creates a revision linked to the source cover letter. Deducts credits (regeneration discount may apply). You may pass jobListingId from list_user_job_listings (omit companyName/role/jobPosition) instead of sending full job fields. Prefer get_user_profile (and optionally get_cover_letter_cost with sourceCoverLetterId) first so you know the user can afford regeneration. After success, tell the user to open the returned viewUrl on the website for a proper formatted view and easy access to templates.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sourceCoverLetterId": "<sourceCoverLetterId>"
},
"name": "regenerate_cover_letter"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Job role / title. Required when jobListingId is not provided. | |
| tone | No | Custom tone content (required when toneTemplate is "custom") | |
| files | No | Previously uploaded files (CV/resume) from list_user_files. Prefer these when present. Optional when personBio holds user-confirmed background from chat. | |
| feedback | No | Requested changes to apply to the regenerated cover letter | |
| language | No | ISO language code, e.g. "en" | en |
| jobMarket | No | Job market index: 0=Europe, 1=NorthAmerica, 2=SouthAndCentralAmerica, 3=MiddleEastAndAfrica, 4=AsiaPacific | |
| keyPoints | No | Up to 7 key points to highlight (max 50 chars each) | |
| personBio | No | Candidate bio / background. When list_user_files returns no CV/resume, use a bio the user confirmed in chat (they may have edited your draft). Draft from grounded data when available; never invent experience, skills, or education. Prefer uploaded files when available; personBio alone is enough to create without files. | |
| personName | No | Candidate full name | |
| companyName | No | Target company name. Required when jobListingId is not provided. | |
| jobPosition | No | Full job description. Required when jobListingId is not provided. | |
| jobListingId | No | ID from list_user_job_listings. When provided, company/role/job description are loaded from the saved listing — omit companyName, role, and jobPosition. | |
| toneTemplate | No | Tone template key, e.g. energetic, professional, custom | energetic |
| desiredLength | No | Length scale 0-4 (0=very short, 4=highly elaborate) | |
| personProfession | No | Candidate profession / title | |
| sourceCoverLetterId | Yes | ID of the cover letter to regenerate |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| kind | Yes | ||
| role | No | ||
| title | No | ||
| status | Yes | ||
| excerpt | No | ||
| viewUrl | Yes | ||
| keyWords | No | ||
| language | No | ||
| createdAt | No | ||
| authorName | No | ||
| companyName | No | ||
| countryCode | No | ||
| creditsUsed | No | ||
| languageLabel | No |