Sign in

v1

latestOpenAPI 3.0.02026-07-1352122.1 KB
api-v1

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

This endpoint requires your JSON Web Token to have the itemusages feature.

post/api/v1/itemusages

Request body

OR

Example request

{
  "cursor": "aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK"
}

Response

Item usages response object

cursorstring

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

has_moreboolean

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

Example response

{
  "items": [
    {
      "uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "timestamp": "2020-06-11T16:32:50-03:00",
      "vault_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "item_uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
      "action": "reveal",
      "user": {
        "uuid": "56YE2TYN2VFYRLNSHKPW5NVT5E",
        "name": "Jack O'Neill"
      },
      "client": {
        "app_name": "1Password Extension",
        "app_version": "20127",
        "platform_name": "Chrome",
        "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
      }
    }
  ],
  "cursor": "aGVsbG8hIGlzIGl0IG1lIHlvdSBhcmUgbG9va2luZyBmb3IK"
}