ApplicantMay change state

# Save Matching Profile

`save_matching_profile`

Save truthful applicant facts privately. Edits pause existing discovery and invalidate approvals. No profile data is shared by saving.

Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.

## Parameters

| Name | Contract |
| --- | --- |
| `profile` Required | object |
| `expected_version` Required | integer |

## Exact input schema

Expand JSON Schema

```
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "profile": {
      "type": "object",
      "properties": {
        "headline": {
          "type": "string",
          "minLength": 3,
          "maxLength": 160
        },
        "target_roles": {
          "minItems": 1,
          "maxItems": 30,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "skills": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "evidence": {
                "type": "string",
                "minLength": 10,
                "maxLength": 600
              }
            },
            "required": [
              "name",
              "evidence"
            ],
            "additionalProperties": false
          }
        },
        "relevant_years": {
          "type": "number",
          "minimum": 0,
          "maximum": 70
        },
        "requirements": {
          "type": "object",
          "properties": {
            "work_state": {
              "description": "US state of residence, e.g. TX. Only explicit eligibility evidence counts.",
              "type": "string",
              "enum": [
                "AL",
                "AK",
                "AZ",
                "AR",
                "CA",
                "CO",
                "CT",
                "DE",
                "DC",
                "FL",
                "GA",
                "HI",
                "ID",
                "IL",
                "IN",
                "IA",
                "KS",
                "KY",
                "LA",
                "ME",
                "MD",
                "MA",
                "MI",
                "MN",
                "MS",
                "MO",
                "MT",
                "NE",
                "NV",
                "NH",
                "NJ",
                "NM",
                "NY",
                "NC",
                "ND",
                "OH",
                "OK",
                "OR",
                "PA",
                "RI",
                "SC",
                "SD",
                "TN",
                "TX",
                "UT",
                "VT",
                "VA",
                "WA",
                "WV",
                "WI",
                "WY"
              ]
            },
            "fully_remote": {
              "type": "boolean"
            },
            "min_annual_base_usd": {
              "description": "USD annual base minimum; commission, estimates, and hourly conversions do not count.",
              "type": "number",
              "exclusiveMinimum": 0,
              "maximum": 10000000
            },
            "max_travel_percent": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          },
          "additionalProperties": false
        },
        "preferred_industries": {
          "default": [],
          "maxItems": 30,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          }
        },
        "preferred_stages": {
          "default": [],
          "maxItems": 3,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "startup",
              "growth",
              "established"
            ]
          }
        },
        "preferred_working_styles": {
          "default": [],
          "maxItems": 5,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "async_first",
              "meeting_heavy",
              "structured",
              "autonomous",
              "collaborative"
            ]
          }
        },
        "work_preferences": {
          "maxItems": 6,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "dimension": {
                "type": "string",
                "enum": [
                  "autonomy",
                  "feedback",
                  "pace",
                  "collaboration",
                  "schedule",
                  "learning"
                ]
              },
              "accepted_values": {
                "minItems": 1,
                "maxItems": 5,
                "type": "array",
                "items": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 5
                }
              },
              "importance": {
                "type": "string",
                "enum": [
                  "must_have",
                  "important",
                  "preference"
                ]
              },
              "note": {
                "default": "",
                "type": "string",
                "maxLength": 600
              }
            },
            "required": [
              "dimension",
              "accepted_values",
              "importance"
            ],
            "additionalProperties": false
          }
        },
        "preference_sharing": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "target_roles",
              "requirements",
              "company_preferences",
              "work_preferences"
            ]
          }
        },
        "contact": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 150
            },
            "email": {
              "type": "string",
              "maxLength": 254,
              "format": "email",
              "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
            }
          },
          "required": [
            "name",
            "email"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "headline",
        "target_roles",
        "skills",
        "requirements",
        "contact"
      ],
      "additionalProperties": false
    },
    "expected_version": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "profile",
    "expected_version"
  ],
  "additionalProperties": false
}
```

## Output schema

Expand output contract

```
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {}
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}
```

## Tool annotations

```
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": false
}
```

[← All applicant tools](/docs/tools?role=applicant) · [Review and receipts](/docs/review)
