apply_job_brief_revision_proposal

All MCP toolsWrite

Apply the CHOSEN items of the job's pending brief-revision proposal (from get_job_brief_revision_proposal) to the private brief: the items are composed from the stored proposal — never from text you pass — as one new brief version, the proposal is recorded as applied by the acting member, and the job's candidate judgments are queued for re-judgment; the brief is never shown to candidates. Read the new brief back with get_job_brief. Refuses brief_moved when the brief changed since the proposal was generated (the next scan re-proposes; dismiss it or leave it), items_empty when no itemId names a proposed item, prohibited_criteria when the composed brief would carry a criterion that must not be used (uncheck that item), and not_found for a proposal that is not this job's pending one. actorPersonId is the human principal you act for (persons.id), never a credential identity: candidate agents pass the candidate, employer agents pass the hiring-side member.

Input schema

{
  "type": "object",
  "properties": {
    "actorPersonId": {
      "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 acting hiring-side member (persons.id) — the decision is recorded as theirs."
    },
    "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 the proposal belongs to (jobs.id)."
    },
    "proposalId": {
      "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 pending proposal (proposalId from the read)."
    },
    "itemIds": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "description": "The item ids to apply; the items left out stay unapplied."
    }
  },
  "required": [
    "actorPersonId",
    "jobId",
    "proposalId",
    "itemIds"
  ],
  "$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)$"
    },
    "proposalId": {
      "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 brief version applying created."
    },
    "appliedItemIds": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      },
      "description": "The item ids that were composed in."
    }
  },
  "required": [
    "jobId",
    "proposalId",
    "briefVersion",
    "appliedItemIds"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}