withdraw_material_share

All MCP toolsWrite

Withdraw ONE company's explicit access to ONE of the person's own materials — the same move as the stop-sharing button on a granted row of their profile shelf. Take organizationId from a granted entry in that material's shares (list_material_disclosures) — the shelf's own list of the companies the person named. The withdrawal closes the company's FUTURE reach — a download already made is outside the system's reach — and a withdrawn standing also blocks milestone auto-opens toward that company under the person's policy until a new explicit grant. Every call appends one company_withdrawn row and records no receipt; the standing in force is the latest act, so repeating a call changes nothing further. A materialId that is not one of the person's own gate-eligible materials, or an organizationId that is no organization, refuses with zero writes. Nobody is notified: this is the person's own act. Opening the standing again is grant_material_share from one of the person's conversations with that company.

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 withdraw — the same id list_materials returns."
    },
    "organizationId": {
      "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 company losing access (organizations.id) — the organizationId of a granted entry in the material's shares."
    }
  },
  "required": [
    "personId",
    "materialId",
    "organizationId"
  ],
  "$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."
    },
    "organizationId": {
      "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 company (organizations.id) — the standing's key in shares."
    },
    "state": {
      "type": "string",
      "const": "withdrawn",
      "description": "The standing now in force toward this company."
    },
    "recordedAt": {
      "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 act was recorded (ISO 8601, UTC) — the appended row's own instant."
    }
  },
  "required": [
    "materialId",
    "organizationId",
    "state",
    "recordedAt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}