ApplicantMay change state
Save Job Offer
save_job_offer
Save or correct private applicant-entered offer terms with source text, currency, pay period, guaranteed versus target bonus, one-time sign-on, estimated equity, conditions and deadlines. Unknown amounts are null, known absence is zero. Confirmed means applicant reviewed the exact terms, not independent verification. Never accepts or rejects an offer.
Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.
Parameters
| Name | Contract |
|---|---|
idOptional | string |
expected_versionRequired | integer |
companyRequired | string |
titleRequired | string |
source_labelRequired | string |
source_textRequired | string |
confirmedRequired | boolean |
currencyRequired | string |
baseRequired | See schema |
periodRequired | string Values: year, month, week, hour |
hours_per_weekOptional | See schema |
weeks_per_yearOptional | See schema |
bonusOptional | See schema |
bonus_typeOptional | string Values: guaranteed, target, none, unknown |
sign_onOptional | See schema |
equity_annual_estimateOptional | See schema |
equity_notesOptional | string |
locationOptional | string |
work_patternOptional | string |
benefitsOptional | string |
clawbackOptional | string |
start_dateOptional | See schema |
deadlineOptional | See schema |
questionsOptional | array |
Exact input schema
Expand JSON Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"expected_version": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"company": {
"type": "string",
"minLength": 1,
"maxLength": 180
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 180
},
"source_label": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"source_text": {
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"confirmed": {
"type": "boolean"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"base": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 10000000000
},
{
"type": "null"
}
]
},
"period": {
"type": "string",
"enum": [
"year",
"month",
"week",
"hour"
]
},
"hours_per_week": {
"default": null,
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
{
"type": "null"
}
]
},
"weeks_per_year": {
"default": null,
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0,
"maximum": 53
},
{
"type": "null"
}
]
},
"bonus": {
"default": null,
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 10000000000
},
{
"type": "null"
}
]
},
"bonus_type": {
"default": "unknown",
"type": "string",
"enum": [
"guaranteed",
"target",
"none",
"unknown"
]
},
"sign_on": {
"default": null,
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 10000000000
},
{
"type": "null"
}
]
},
"equity_annual_estimate": {
"default": null,
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 10000000000
},
{
"type": "null"
}
]
},
"equity_notes": {
"default": "",
"type": "string",
"maxLength": 4000
},
"location": {
"default": "",
"type": "string",
"maxLength": 4000
},
"work_pattern": {
"default": "",
"type": "string",
"maxLength": 4000
},
"benefits": {
"default": "",
"type": "string",
"maxLength": 4000
},
"clawback": {
"default": "",
"type": "string",
"maxLength": 4000
},
"start_date": {
"default": null,
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"deadline": {
"default": null,
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"questions": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
},
"required": [
"expected_version",
"company",
"title",
"source_label",
"source_text",
"confirmed",
"currency",
"base",
"period"
],
"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
}