unpublish_job_posting

All MCP toolsWrite

Take a job posting offline (published_at cleared; the document stays editable as a draft and leaves matching as its chunks converge to zero). Unpublishing an already-draft posting is a no-op. Use the version returned by get_job_posting / list_job_postings as expectedVersion — a stale value refuses with a version conflict naming the expected and latest versions; re-read and retry.

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 to unpublish (jobs.id)."
    },
    "expectedVersion": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The version you loaded — unpublish does NOT increment it."
    }
  },
  "required": [
    "jobId",
    "expectedVersion"
  ],
  "$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)$"
    },
    "publishedAt": {
      "type": "null",
      "description": "Always null — the posting is a draft again."
    }
  },
  "required": [
    "jobId",
    "publishedAt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}