get_job_brief_org_defaults

Get a job's inheritance of the organization's brief defaults

All MCP toolsRead

Read how one job inherits the organization's brief defaults: the version its brief is pinned to, every pinned row with this job's state for it (inherited, overridden with the job's own text, or suppressed for this job), whether the organization has moved on since (recheckPending), the row-by-row changes adopting would bring (added, removed, revised — with the ones this job's overrides keep out), and the judgments adopting would send back for re-judgment. A job with no brief yet previews the current defaults (pinnedVersion null): its first brief save pins that version. Pass currentVersion as toVersion to adopt_org_brief_defaults; pass a row id to save_job_brief_org_override. The team's own judgment material — never shown to candidates.

Input schema

{
  "type": "object",
  "properties": {
    "jobId": {
      "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 job (jobs.id)."
    }
  },
  "required": [
    "jobId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "jobId": {
      "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)$"
    },
    "pinnedVersion": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "The defaults version this job's brief composes with; null when no brief exists yet."
    },
    "currentVersion": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "The organization's current defaults version (0 when none are saved)."
    },
    "recheckPending": {
      "type": "boolean",
      "description": "true when the organization's defaults moved past this job's pinned version."
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "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 row id — what save_job_brief_org_override takes."
          },
          "category": {
            "type": "string",
            "enum": [
              "meet",
              "decline",
              "salary",
              "talking",
              "avoid"
            ],
            "description": "The principle's category: meet — whom to meet; decline — whom to decline; salary — the shared salary stance; talking — how to speak about the company; avoid — expressions never to use."
          },
          "text": {
            "type": "string",
            "description": "The organization's text for the row (the pinned version)."
          },
          "state": {
            "type": "string",
            "enum": [
              "inherited",
              "overridden",
              "suppressed"
            ],
            "description": "inherited — the job applies the organization's text; overridden — the job applies its own text (overrideText); suppressed — the job does not apply this row."
          },
          "overrideText": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The job's replacement text when overridden; null otherwise."
          },
          "recheck": {
            "type": "boolean",
            "description": "true when this row is among the pending changes (revised or removed)."
          }
        },
        "required": [
          "id",
          "category",
          "text",
          "state",
          "overrideText",
          "recheck"
        ],
        "additionalProperties": false
      },
      "description": "The pinned document's rows in order, with this job's state for each."
    },
    "pendingChanges": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "added",
              "removed",
              "revised"
            ],
            "description": "added — a row the organization added since the pin; removed — a pinned row the organization deleted; revised — a pinned row whose text or category changed."
          },
          "rowId": {
            "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)$"
          },
          "category": {
            "type": "string",
            "enum": [
              "meet",
              "decline",
              "salary",
              "talking",
              "avoid"
            ],
            "description": "The principle's category: meet — whom to meet; decline — whom to decline; salary — the shared salary stance; talking — how to speak about the company; avoid — expressions never to use."
          },
          "currentText": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "What this job composes with today (the pinned text); null for added."
          },
          "nextText": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "What adopting takes (the current text); null for removed."
          },
          "unaffectedByOverride": {
            "type": "boolean",
            "description": "true when this job's own override keeps the change out (a revised row it overrides, a removed row it already suppresses) — adopting does not change how it applies here."
          }
        },
        "required": [
          "kind",
          "rowId",
          "category",
          "currentText",
          "nextText",
          "unaffectedByOverride"
        ],
        "additionalProperties": false
      },
      "description": "Pinned-to-current differences; empty unless recheckPending."
    },
    "impact": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "positive": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "even": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "weak": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "total",
            "positive",
            "even",
            "weak"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "When adopting the current defaults would change this job's effective brief: the job's judged candidate pairs and their CURRENT fit readings — how many judgments adopting sends back for re-judgment, never a predicted movement. null when nothing is pending or adopting changes nothing effective."
    }
  },
  "required": [
    "jobId",
    "pinnedVersion",
    "currentVersion",
    "recheckPending",
    "rows",
    "pendingChanges",
    "impact"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

On this page