Docs
HiringMay change state

Save Hiring Member

save_hiring_member

Owner-only explicit access change for another member. Administrator/recruiter have company write access; hiring managers can record reviewed decisions and team work but cannot export; interviewers can read and add team work only for assigned jobs. Changing roles invalidates pending approvals through the client version.

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

Parameters

NameContract
client_id
Required
string
member
Required
string
expected_version
Required
integer
role
Required
string
Values: administrator, recruiter, hiring_manager, interviewer
job_ids
Optional
array

Exact input schema

Expand JSON Schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "client_id": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    },
    "member": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    },
    "expected_version": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "role": {
      "type": "string",
      "enum": [
        "administrator",
        "recruiter",
        "hiring_manager",
        "interviewer"
      ]
    },
    "job_ids": {
      "default": [],
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z0-9_-]{1,100}$"
      }
    }
  },
  "required": [
    "client_id",
    "member",
    "expected_version",
    "role"
  ],
  "additionalProperties": false
}

Output schema

Expand output contract
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "member": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9_-]{1,100}$"
        },
        "version": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "role": {
          "type": "string"
        },
        "job_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[a-zA-Z0-9_-]{1,100}$"
          }
        }
      },
      "required": [
        "member",
        "version",
        "role",
        "job_ids"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}

Tool annotations

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

← All hiring tools · Review and receipts