Docs
ApplicantMay change state

Save Representative Fact

save_representative_fact

Add or correct one private representative fact by stable ID, retaining all other fields. Set confirmed only after applicant confirmation of its exact wording. Optional career evidence must match its current confirmed text/version. Does not publish.

Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.

Parameters

NameContract
expected_version
Required
integer
fact
Required
object

Exact input schema

Expand JSON Schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "expected_version": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "fact": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9_-]{1,100}$"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 180
        },
        "category": {
          "type": "string",
          "enum": [
            "overview",
            "systems",
            "leadership",
            "journey"
          ]
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4000
        },
        "metric": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "label": {
          "type": "string",
          "minLength": 1,
          "maxLength": 180
        },
        "tags": {
          "maxItems": 12,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          }
        },
        "source_label": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300
        },
        "confirmed": {
          "type": "boolean"
        },
        "career_evidence": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[a-zA-Z0-9_-]{1,100}$"
            },
            "version": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "version"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "id",
        "title",
        "category",
        "text",
        "metric",
        "label",
        "tags",
        "source_label",
        "confirmed"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "expected_version",
    "fact"
  ],
  "additionalProperties": false
}

Output schema

Expand output contract
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {}
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}

Tool annotations

{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": false
}

← All applicant tools · Review and receipts