{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/1password/refs/heads/main/json-structure/1password-events-item-usage-structure.json",
  "name": "ItemUsage",
  "description": "Represents a record of an item in a shared vault being accessed, modified, or used.",
  "type": "object",
  "properties": {
    "uuid": {
      "type": "uuid",
      "description": "The unique identifier for the item usage record."
    },
    "timestamp": {
      "type": "datetime",
      "description": "When the item was accessed."
    },
    "used_version": {
      "type": "int32",
      "description": "The version of the item that was used."
    },
    "vault_uuid": {
      "type": "uuid",
      "description": "The UUID of the vault containing the item."
    },
    "item_uuid": {
      "type": "uuid",
      "description": "The UUID of the item that was used."
    },
    "action": {
      "type": "string",
      "description": "The type of action performed on the item.",
      "enum": [
        "fill",
        "copy",
        "reveal",
        "sso-fill",
        "secure-copy"
      ]
    },
    "user": {
      "$ref": "#/components/schemas/EventUser"
    },
    "client": {
      "$ref": "#/components/schemas/EventClient"
    },
    "location": {
      "$ref": "#/components/schemas/EventLocation"
    }
  }
}