HiringMay change state
Prepare Stage Change
prepare_stage_change
Propose an internal stage change and optional matching applicant-visible status. Does not change either status. Create a change_stage review for proposal_id; an authenticated person must approve before commit_stage_change. Never infer hiring decisions.
Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.
Parameters
| Name | Contract |
|---|---|
job_idRequired | string |
application_idRequired | string |
expected_versionRequired | integer |
stageRequired | string Values: received, reviewing, interview, offer, declined, hired |
public_statusOptional | See schema |
Exact input schema
Expand JSON Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"application_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"expected_version": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"stage": {
"type": "string",
"enum": [
"received",
"reviewing",
"interview",
"offer",
"declined",
"hired"
]
},
"public_status": {
"default": null,
"anyOf": [
{
"type": "string",
"enum": [
"reviewing",
"interview",
"declined",
"hired"
]
},
{
"type": "null"
}
]
}
},
"required": [
"job_id",
"application_id",
"expected_version",
"stage"
],
"additionalProperties": false
}Output schema
Expand output contract
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"proposal_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,100}$"
},
"state": {
"type": "string",
"const": "awaiting_review"
},
"required_review": {
"type": "string",
"const": "change_stage"
},
"next_action": {
"type": "string",
"const": "create_review"
},
"notice": {
"type": "string"
}
},
"required": [
"proposal_id",
"state",
"required_review",
"next_action",
"notice"
],
"additionalProperties": false
}
},
"required": [
"data"
],
"additionalProperties": false
}Tool annotations
{
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false
}