{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/mandiant/json-schema/mandiant-alert-document-schema.json",
  "title": "AlertDocument",
  "description": "A document that is associated with an alert.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/mandiant-projects-api-openapi.yml#/components/schemas/AlertDocument",
  "type": "object",
  "properties": {
    "author": {
      "readOnly": true,
      "type": "string",
      "description": "Output only. The author of the document."
    },
    "content": {
      "readOnly": true,
      "type": "string",
      "description": "Output only. The content of the document."
    },
    "createTime": {
      "description": "Output only. The timestamp of the original external publication of the document.",
      "format": "google-datetime",
      "readOnly": true,
      "type": "string"
    },
    "source": {
      "description": "Output only. Source of the intel item, e.g. DarkMarket.",
      "readOnly": true,
      "type": "string"
    },
    "title": {
      "type": "string",
      "description": "Output only. The title of the document, if available.",
      "readOnly": true
    },
    "translation": {
      "$ref": "#/$defs/AlertDocumentTranslation",
      "description": "Output only. The translation of the document, if available."
    },
    "ingestTime": {
      "description": "Output only. Time when GTI received the intel.",
      "readOnly": true,
      "type": "string",
      "format": "google-datetime"
    },
    "communicationContext": {
      "$ref": "#/$defs/CommunicationContext",
      "description": "Output only. Platform identifiers of the message, thread and channel."
    },
    "collectionTime": {
      "type": "string",
      "description": "Output only. Time when the origin source collected the intel.",
      "format": "google-datetime",
      "readOnly": true
    },
    "sourceUri": {
      "description": "Output only. URI of the intel item from the source.",
      "readOnly": true,
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "Identifier. Server generated name for the alert document. format is projects/{project}/alerts/{alert}/documents/{document}"
    },
    "aiSummary": {
      "description": "Output only. AI summary of the document.",
      "type": "string",
      "readOnly": true
    },
    "languageCode": {
      "readOnly": true,
      "description": "Output only. The language code of the document.",
      "type": "string"
    },
    "sourceUpdateTime": {
      "description": "Output only. Time when the intel was last updated by the source.",
      "readOnly": true,
      "format": "google-datetime",
      "type": "string"
    }
  },
  "$defs": {
    "AlertDocumentTranslation": {
      "properties": {
        "translatedContent": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The translated content of the document."
        },
        "translatedTitle": {
          "type": "string",
          "readOnly": true,
          "description": "Output only. The translated title of the document."
        }
      },
      "type": "object",
      "description": "The translation of an alert document."
    },
    "CommunicationContext": {
      "description": "Detailed communication context metadata for documents originating from deep and dark web communication channels.",
      "properties": {
        "channelUrl": {
          "description": "Optional. URL of the communication channel.",
          "type": "string"
        },
        "messageId": {
          "type": "string",
          "description": "Optional. Message or post identifier on the originating platform."
        },
        "channelDescription": {
          "type": "string",
          "description": "Optional. Description of the communication channel."
        },
        "serviceName": {
          "description": "Optional. Service from the collection event origin (e.g. forum or chat service name).",
          "type": "string"
        },
        "channelPath": {
          "type": "string",
          "description": "Optional. Channel path (e.g. forum path or sub-channel)."
        },
        "threadId": {
          "description": "Optional. Conversation thread identifier.",
          "type": "string"
        },
        "channelName": {
          "type": "string",
          "description": "Optional. Name of the communication channel."
        }
      },
      "type": "object"
    }
  }
}