Update Application Profile
getmattered_update_application_profileDestructiveIdempotent
Saves only the fields passed, each a value the user stated. Self-identification answers are optional and accept prefer_not_to_say. Sends and spends nothing.
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": "getmattered_update_application_profile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City. | |
| phone | No | Phone number, as the user gave it, for example +1 555 123 4567. | |
| state | No | State, province or region. | |
| gender | No | Optional and sensitive. Gender, for the voluntary self-identification questions on employer forms. prefer_not_to_say declines to answer. | |
| country | No | Country. | |
| pronouns | No | Optional and sensitive. Pronouns in the user's own words, for example she/her, as stated and never inferred. | |
| zip_code | No | ZIP or postal code. | |
| ethnicity | No | Optional and sensitive. Ethnicity, for the voluntary self-identification questions on employer forms. prefer_not_to_say declines to answer. | |
| github_url | No | GitHub profile URL. | |
| linkedin_url | No | LinkedIn profile URL. | |
| address_line1 | No | Street address, line 1. | |
| address_line2 | No | Street address, line 2, such as an apartment or suite. | |
| date_of_birth | No | Date of birth as YYYY-MM-DD, when the user gives it; few employer forms ask for it. | |
| notice_period | No | Notice period before the user can start. | |
| portfolio_url | No | Portfolio or personal website URL. | |
| veteran_status | No | Optional and sensitive. Veteran status, for the voluntary self-identification questions on employer forms. prefer_not_to_say declines to answer. | |
| current_employer | No | Current employer. | |
| disability_status | No | Optional and sensitive. Disability status, for the voluntary self-identification questions on employer forms. prefer_not_to_say declines to answer. | |
| highest_education | No | Highest education level completed. | |
| personal_narrative | No | A short note, up to 500 characters, on career gaps, changes or short stints. Used for interview preparation. | |
| security_clearance | No | Security clearance level. prefer_not_to_say declines to answer. | |
| sexual_orientation | No | Optional and sensitive. Sexual orientation, for the voluntary self-identification questions on employer forms. prefer_not_to_say declines to answer. | |
| travel_willingness | No | How much work travel the user accepts. | |
| work_authorization | No | Work authorization status. | |
| willing_to_relocate | No | Whether the user is willing to relocate for a job. | |
| years_of_experience | No | Total years of professional experience. | |
| available_start_date | No | Earliest start date as YYYY-MM-DD. | |
| relocation_locations | No | Places the user would relocate to, as "City, Country" or "Country". | |
| criminal_record_status | No | Whether the user has a conviction they are legally required to disclose. prefer_not_to_say declines to answer. | |
| background_check_consent | No | Whether the user consents to a background check where a role requires one. prefer_not_to_say declines to answer. | |
| export_control_us_person | No | Whether the user is a U.S. person for export-control (ITAR or EAR) purposes. prefer_not_to_say declines to answer. | |
| related_to_employee_status | No | Whether the user is related to an employee of a company they apply to. prefer_not_to_say declines to answer. | |
| restrictive_covenant_status | No | Whether the user is bound by a non-compete or non-solicit agreement with a former employer. prefer_not_to_say declines to answer. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changed | Yes | The input fields this call saved. Empty from getmattered_get_application_profile, which only reads. | |
| profile | Yes | The saved answers employer forms are filled from, after this call. Field names are the API's camelCase twins of the inputs. | |
| setupStep | No | Present while account setup is open: the first setup step. | |
| openQuestions | Yes | Kept for existing clients, as an empty list. The answer text names the fields the user can add. Null when those details could not be read. | |
| missingRequiredForApply | Yes | Profile fields employer forms can require that are empty. GetMattered fills address fields from the user's saved address and location. With gap filling on, it also fills an empty postal code. With gap filling off, a form that requires a postal code is not sent until the profile has one. An empty state or country never stops a form. The user adds each field once on the profile, not per application. |