{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://jambonz.org/schema/verbs/tag",
  "minVersion": "0.9.6",
  "title": "Tag",
  "description": "Attaches arbitrary metadata to the current call. Tagged data is included in all subsequent webhook requests and in the call detail record (CDR). Useful for tracking business context, routing decisions, or analytics data through the call lifecycle.",
  "type": "object",
  "properties": {
    "verb": {
      "const": "tag"
    },
    "id": {
      "type": "string",
      "description": "An optional unique identifier for this verb instance."
    },
    "data": {
      "type": "object",
      "description": "An object containing the metadata to attach to the call. Keys and values are application-defined.",
      "additionalProperties": true,
      "examples": [
        {
          "customerId": "12345",
          "department": "support",
          "priority": "high"
        }
      ]
    }
  },
  "required": [
    "data"
  ],
  "examples": [
    {
      "verb": "tag",
      "data": {
        "customerId": "12345",
        "intent": "billing-inquiry"
      }
    }
  ]
}
