set_material_disclosure_policy

All MCP toolsWrite

Set ONE material's disclosure policy — the stage of a pair at which the material opens toward the company — the same move as one row of the person's own privacy page. Read list_material_disclosures first for the policy in force and list_materials for the materialId. The four values are one ladder: private (explicit per-company grants only), on_interview_passed, on_scheduling, on_match — each later value opens at an earlier stage of the pair. The policy answers milestones that arrive AFTER it: loosening opens nothing toward pairs that already passed the stage, and tightening closes nothing already open — so a material set to a milestone policy right after registration is still closed until a pair reaches that milestone. Every call appends one policy_set row; the value in force is the latest one, so repeating a call changes nothing further. A materialId that is not one of the person's own gate-eligible materials (a url material is not one) 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 material's owner (persons.id — self)."
    },
    "materialId": {
      "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 material to set the policy of — the same id list_materials returns."
    },
    "policy": {
      "type": "string",
      "enum": [
        "private",
        "on_match",
        "on_scheduling",
        "on_interview_passed"
      ],
      "description": "The stage at which this material opens from now on."
    }
  },
  "required": [
    "personId",
    "materialId",
    "policy"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "materialId": {
      "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 material (profile_import_sources.id) — share_material's materialId."
    },
    "policy": {
      "type": "string",
      "enum": [
        "private",
        "on_match",
        "on_scheduling",
        "on_interview_passed"
      ],
      "description": "The value now in force for this material."
    },
    "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 policy was recorded (ISO 8601, UTC)."
    }
  },
  "required": [
    "materialId",
    "policy",
    "setAt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}