Edit my preferences
editPreferencesChange the candidate's job preferences and profile data, the same fields readPreferences returns. Send only the fields to change. null clears a field (a list field becomes empty), except the name, linkedin_url, salary_basis and the allow and autopilot settings, which only take a new value, and salary_currency, which clears only together with the salary bounds; an empty string clears phone or linkedin_url. A value Clera cannot use is listed in skippedFields with the reason, and missing from changedFields. A list field replaces the whole list, so send the complete set. Companies to block go in add_blocked_companies and remove_blocked_companies by name. For sales, AE, SDR, BDR and customer success roles, or whenever the candidate mentions OTE or commission, ask whether their number is base or on-target: one on-target figure goes in salary_lower_bound with salary_basis "ote"; base and OTE both given go in the salary and ote fields with salary_basis "base".
Read the current values with readPreferences first and confirm the change with the candidate before writing; matching reruns on the new values. A new linkedin_url also refreshes the profile from LinkedIn. allow_direct_submission true lets Clera introduce them to a role that fits without asking first. appetite paused stops new matches; to stop for a while or for good, use setJobSearchStatus. memory adds or clears the notes Clera keeps, five at most. postal_address and work_authorized_countries only fill job applications. Login email and resumes are changed on the dashboard.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "editPreferences"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone | No | Phone number for contact | |
| roles | No | Preferred job roles as exact names from Clera's role list. When no name matches exactly, provide several similar ones. Examples: If user says "Software Engineer", provide ["Full Stack Engineer", "Backend Engineer", "Frontend Engineer"]. If user says "Designer", provide ["Design", "Product Designer", "UI/UX", "UX Designer"]. Only use "Other" as a last resort. A name not on the list is skipped and returned in skippedFields. | |
| x_url | No | X (Twitter) profile URL | |
| memory | No | Notes Clera keeps about the candidate's job search: motivations, constraints, how they like to be contacted. Save one only when the candidate asks Clera to remember it, in their own words; never health, family, religion or other sensitive details. Five notes at most; clear one with value null to make room. | |
| skills | No | Array of skills with proficiency levels and years of experience | |
| appetite | No | How actively the candidate is looking: searching, receptive (open to hearing) or paused. | |
| lastname | No | Last name | |
| timezone | No | The talent's timezone as they confirmed it: an IANA zone (Europe/Berlin), a city or an abbreviation (PT, CET). Wins over the zone derived from location; saving a new location without it clears it. | |
| firstname | No | First name | |
| job_types | No | Preferred job types. Options: Full-Time, Part-time, Internship, Contract, Freelance | |
| github_url | No | GitHub profile URL | |
| other_links | No | Other relevant links (array of URLs as strings, or objects with {type, address}) | |
| linkedin_url | No | LinkedIn profile URL; an empty string clears the stored URL, null leaves it unchanged | |
| salary_basis | No | What salary_lower_bound/salary_upper_bound denote: 'base' (default) for base salary, 'ote' when the candidate quoted a single on-target-earnings figure (base + commission/bonus, typical for sales roles) without a separate base | |
| notice_period | No | Notice period before candidate can start a new role (e.g., "Immediately available", "2 weeks", "1 month", "2 months", "3 months") | |
| portfolio_url | No | Portfolio or personal website URL | |
| postal_address | No | Postal address used only to fill external job applications. country is an ISO-2 code. | |
| ote_lower_bound | No | Minimum expected on-target earnings (annual, same currency as salary_currency); only when the candidate states OTE separately from base | |
| ote_upper_bound | No | Maximum expected on-target earnings (annual, same currency as salary_currency) | |
| salary_currency | No | Currency for salary bounds (USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY, INR, SGD, BRL, MXN, PLN, SEK, DKK, NOK, ARS, COP, PEN, KES, PHP) | |
| salary_importance | No | How important is minimum salary? DEALBREAKER = must match (excludes jobs below minimum), IMPORTANT = weighted higher, NICE_TO_HAVE = flexible (default) | |
| cover_letter_notes | No | The talent's own instructions for writing their cover letters, in their words (e.g. employers never to name, tone, what to lead with). Read only when a cover letter is written. | |
| preferred_industry | No | Preferred industries. Options: AI, Fintech, Healthtech, Hardware, Edtech, SaaS, E-commerce, Marketplace, Cybersecurity, Climate, Biotech, Mobility, Gaming, Media, Defense, Aerospace, Government, Healthcare, Financial Services, Insurance, Developer Tools, Data & Infrastructure, Real Estate, Logistics, Consumer, Legal, Other | |
| salary_lower_bound | No | Minimum expected salary (annual, in specified currency) | |
| salary_upper_bound | No | Maximum expected salary (annual, in specified currency) | |
| location_importance | No | How important is location/relocation preference? DEALBREAKER = must match (excludes jobs), IMPORTANT = weighted higher, NICE_TO_HAVE = flexible (default) | |
| available_start_date | No | Earliest available start date (ISO 8601 format: YYYY-MM-DD) | |
| job_types_importance | No | How important is job type preference? DEALBREAKER = must match (excludes jobs), IMPORTANT = weighted higher, NICE_TO_HAVE = flexible (default) | |
| add_blocked_companies | No | Company names to ADD to the talent's blocklist — matchmaking will never suggest jobs from these companies. Appends to existing list (deduplicates automatically). Use the company's common name (e.g., 'Google', 'Meta', 'Amazon'). | |
| preferred_job_comment | No | Additional comments about job preferences (max 5000 characters) | |
| visa_sponsorship_type | No | Visa type(s) selected by the talent (e.g. f1_opt, h1b, tn, other). Empty/NULL when sponsorship is not needed. | |
| allow_company_outreach | No | Whether companies are allowed to reach out to this talent | |
| preferred_company_size | No | Preferred company size in terms of employees. Options: 1-10, 11-50, 51-200, 201-1000, 1000+ | |
| allow_direct_submission | No | Whether Clera can submit the talent for opportunities without prior approval (default: false, always ask before submitting) | |
| visa_sponsorship_needed | No | Whether the candidate needs visa sponsorship to work | |
| willingness_to_relocate | No | Willingness to relocate for work. Options: No, Within my country, Within my continent, Everywhere. Legacy values accepted: "Yes" → Within my continent, "Anywhere"/"Global" → Everywhere, "Within my city" → No. | |
| remove_blocked_companies | No | Company names to REMOVE from the talent's blocklist (case-insensitive match). Use when a talent changes their mind about a previously blocked company. | |
| work_authorized_countries | No | ISO-2 codes of countries the talent can legally work in without sponsorship | |
| preferred_work_environment | No | Preferred workplace types (e.g., ['remote', 'hybrid']). Options: remote, hybrid, on-site. Open to either office or remote is ['on-site', 'remote']. | |
| preferred_work_geolocations | No | Cities or regions the candidate wants to work in, as plain names ('Berlin', 'San Francisco, CA', 'California'). Replaces the whole list. A name Clera cannot place is dropped; 'Remote' adds remote to preferred_work_environment instead. | |
| visa_sponsorship_importance | No | How important is visa sponsorship? DEALBREAKER = must offer sponsorship (excludes jobs), IMPORTANT = weighted higher, NICE_TO_HAVE = flexible (default) | |
| preferred_company_funding_stage | No | Preferred company funding stage. Options: Bootstrapped, Series A-E, Public, Other | |
| visa_sponsorship_further_details | No | Additional details about visa requirements (max 1000 characters) | |
| preferred_work_environment_importance | No | How important is work environment preference? DEALBREAKER = must match (excludes jobs), IMPORTANT = weighted higher, NICE_TO_HAVE = flexible (default) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changedFields | Yes | ||
| skippedFields | Yes |