set_disclosure_policy

All MCP toolsWrite

Set ONE of the person's disclosure settings — the stage of a pair at which their name (identity, and with it the full profile), email, or phone opens toward the company — the same move as one row of their own privacy page. Read get_disclosure_policies first for the values in force. The four values are one ladder: private (never by stage), on_interview_passed, on_scheduling, on_match — each later value opens at an earlier stage of the pair. The setting answers requests and milestones that arrive AFTER it: loosening opens nothing toward pairs that already passed the stage, and tightening closes nothing already open. The phone setting is accepted whether or not a verified contact-use number is registered yet — it governs the number the person registers later. Every call appends one setting row; the value in force is the latest one, so repeating a call changes nothing further. An id that resolves to no person refuses with zero writes.

Input schema

{
  "type": "object",
  "properties": {
    "personId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The person whose setting to change (persons.id — self)."
    },
    "subject": {
      "type": "string",
      "enum": [
        "identity",
        "email",
        "phone"
      ],
      "description": "Person-level disclosure subject: \"identity\" (the person's name — the whole-profile full grant), \"email\" (the sign-in email address as contact channel), or \"phone\" (the verified contact-use phone number). Separate shareables — never bundled."
    },
    "policy": {
      "type": "string",
      "enum": [
        "private",
        "on_match",
        "on_scheduling",
        "on_interview_passed"
      ],
      "description": "The stage at which this subject opens from now on."
    }
  },
  "required": [
    "personId",
    "subject",
    "policy"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "subject": {
      "type": "string",
      "enum": [
        "identity",
        "email",
        "phone"
      ],
      "description": "Person-level disclosure subject: \"identity\" (the person's name — the whole-profile full grant), \"email\" (the sign-in email address as contact channel), or \"phone\" (the verified contact-use phone number). Separate shareables — never bundled."
    },
    "policy": {
      "type": "string",
      "enum": [
        "private",
        "on_match",
        "on_scheduling",
        "on_interview_passed"
      ],
      "description": "The value now in force for this subject."
    },
    "setAt": {
      "type": "string",
      "format": "date-time",
      "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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the setting was recorded (ISO 8601, UTC)."
    }
  },
  "required": [
    "subject",
    "policy",
    "setAt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}