Retrieves events for each usage of an item stored in a shared vault within a 1Password account

curl --request POST \
  --url https://events.1password.com/api/v2/itemusages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cursor": "aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK"
}
'

{
  "items": [
    {
      "uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "timestamp": "2020-06-11T16:32:50-03:00",
      "used_version": 123,
      "vault_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "item_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "action": "reveal",
      "user": {
        "uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
        "name": "Jack O'Neill",
        "email": "jsmith@example.com",
        "user_type": "user",
        "user_account_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E"
      },
      "client": {
        "app_name": "1Password Extension",
        "app_version": "20127",
        "platform_name": "Chrome",
        "platform_version": "<string>",
        "os_name": "MacOSX",
        "os_version": "10.15.6",
        "ip_address": "13.227.95.22"
      },
      "location": {
        "country": "CA",
        "region": "Ontario",
        "city": "Toronto",
        "longitude": 43.64,
        "latitude": -79.433
      },
      "account_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E"
    }
  ],
  "cursor": "aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK",
  "has_more": true
}

{
  "Error": {
    "Message": "<string>"
  }
}

{
  "Error": {
    "Message": "<string>"
  }
}

{
  "Error": {
    "Message": "<string>"
  }
}

POST

api

itemusages

curl --request POST \
  --url https://events.1password.com/api/v2/itemusages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cursor": "aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK"
}
'

{
  "items": [
    {
      "uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "timestamp": "2020-06-11T16:32:50-03:00",
      "used_version": 123,
      "vault_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "item_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "action": "reveal",
      "user": {
        "uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
        "name": "Jack O'Neill",
        "email": "jsmith@example.com",
        "user_type": "user",
        "user_account_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E"
      },
      "client": {
        "app_name": "1Password Extension",
        "app_version": "20127",
        "platform_name": "Chrome",
        "platform_version": "<string>",
        "os_name": "MacOSX",
        "os_version": "10.15.6",
        "ip_address": "13.227.95.22"
      },
      "location": {
        "country": "CA",
        "region": "Ontario",
        "city": "Toronto",
        "longitude": 43.64,
        "latitude": -79.433
      },
      "account_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E"
    }
  ],
  "cursor": "aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK",
  "has_more": true
}

{
  "Error": {
    "Message": "<string>"
  }
}

{
  "Error": {
    "Message": "<string>"
  }
}

{
  "Error": {
    "Message": "<string>"
  }
}

Authorizations

Authorization

string

header

required

A JWT SA token issued to this service

Body

application/json

Option 1
Option 2

Cursor

cursor

string

Cursor to fetch more data if available or continue the polling process if required

Example:

"aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK"

Response

Item usages response object

An object wrapping cursor properties and a list of items usages

items

object[]

Show child attributes

cursor

string

Cursor to fetch more data if available or continue the polling process if required

Example:

"aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK"

has_more

boolean

Whether there may still be more data to fetch using the returned cursor. If true, the subsequent request could still be empty.