save_job_brief_org_override

All MCP toolsWrite

Set how one job applies one row of the organization's brief defaults: replace the row's text with the job's own, suppress the row for this job, or inherit the organization's text again. The row must be in the job's pinned document (rows from get_job_brief_org_defaults). The effective brief is recomposed and linted; the brief version moves only when the effective brief really changed, and no re-judgment is queued (the next scan picks it up). A job with no brief yet gets one, pinned to the current defaults. Refuses org_row_not_found for a row outside the pinned document, job_closed for a filled or closed seat, and prohibited_criteria when the replacement would carry a criterion that must not be used.

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)."
    },
    "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)$",
      "description": "The organization row to override (a row id from the read)."
    },
    "override": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "mode": {
              "type": "string",
              "const": "replace",
              "description": "Apply the job's own text in place of the row's."
            },
            "text": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500,
              "description": "This job's replacement text for the row."
            }
          },
          "required": [
            "mode",
            "text"
          ]
        },
        {
          "type": "object",
          "properties": {
            "mode": {
              "type": "string",
              "const": "suppress",
              "description": "Do not apply this row on this job (the row stays organization-side)."
            }
          },
          "required": [
            "mode"
          ]
        },
        {
          "type": "object",
          "properties": {
            "mode": {
              "type": "string",
              "const": "inherit",
              "description": "Back to the organization's text — removes the job's override."
            }
          },
          "required": [
            "mode"
          ]
        }
      ],
      "description": "replace — the job applies its own text (text required); suppress — the job does not apply the row; inherit — the job applies the organization's text again."
    }
  },
  "required": [
    "jobId",
    "rowId",
    "override"
  ],
  "$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)$"
    },
    "briefVersion": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "The job's brief version after the save (bumped only on a real effective change)."
    }
  },
  "required": [
    "jobId",
    "briefVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}