1Password · Schema

ItemUsage

Represents a record of an item in a shared vault being accessed, modified, or used.

Password ManagerPasswordsSecuritySecrets

Properties

Name	Type	Description
uuid	string	The unique identifier for the item usage record.
timestamp	string	When the item was accessed.
used_version	integer	The version of the item that was used.
vault_uuid	string	The UUID of the vault containing the item.
item_uuid	string	The UUID of the item that was used.
action	string	The type of action performed on the item.
user	object
client	object
location	object

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/1password/refs/heads/main/json-schema/1password-events-item-usage-schema.json",
  "title": "ItemUsage",
  "description": "Represents a record of an item in a shared vault being accessed, modified, or used.",
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "format": "uuid",
      "description": "The unique identifier for the item usage record."
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "When the item was accessed."
    },
    "used_version": {
      "type": "integer",
      "description": "The version of the item that was used."
    },
    "vault_uuid": {
      "type": "string",
      "format": "uuid",
      "description": "The UUID of the vault containing the item."
    },
    "item_uuid": {
      "type": "string",
      "format": "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"
    }
  }
}