ApplicantMay change state

# Save Company Brief

`save_company_brief`

Create or revise a private company brief with exact source quotes. Distinguish source excerpts, agent interpretations, conflicts and unknowns. Conflicts need two sources. No funding, culture, identity or hiring claim is independently verified. Retain source URLs and dates and unanswered questions.

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

## Parameters

| Name | Contract |
| --- | --- |
| `id` Optional | string |
| `expected_version` Required | integer |
| `company` Required | string |
| `source_ids` Required | array |
| `findings` Required | array |
| `questions` Required | array |
| `notes` Optional | string |

## Exact input schema

Expand JSON Schema

```
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    },
    "expected_version": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "company": {
      "type": "string",
      "minLength": 1,
      "maxLength": 180
    },
    "source_ids": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z0-9_-]{1,100}$"
      }
    },
    "findings": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string",
            "enum": [
              "product",
              "customers",
              "work",
              "hiring",
              "funding",
              "risk",
              "other"
            ]
          },
          "statement": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "status": {
            "type": "string",
            "enum": [
              "source_statement",
              "inference",
              "conflict",
              "unknown"
            ]
          },
          "citations": {
            "maxItems": 6,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "source_id": {
                  "type": "string",
                  "pattern": "^[a-zA-Z0-9_-]{1,100}$"
                },
                "quote": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 1200
                }
              },
              "required": [
                "source_id",
                "quote"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "topic",
          "statement",
          "status",
          "citations"
        ],
        "additionalProperties": false
      }
    },
    "questions": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    },
    "notes": {
      "default": "",
      "type": "string",
      "maxLength": 4000
    }
  },
  "required": [
    "expected_version",
    "company",
    "source_ids",
    "findings",
    "questions"
  ],
  "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](/docs/tools?role=applicant) · [Review and receipts](/docs/review)
