1P1password
api-v1

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

Changed on

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

post/api/v1/itemusages

Request

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"
}

Changes

  • 359da8b22780Revision changes
    • breaking

      the /// response's property type changed from no type to string for status

    • warning

      added the new enter-item-edit-mode enum value to the /// response property for the response status

    • warning

      added the new export enum value to the /// response property for the response status

    • warning

      added the new fill enum value to the /// response property for the response status

    • warning

      added the new reveal enum value to the /// response property for the response status

    • warning

      added the new secure-copy enum value to the /// response property for the response status

    • warning

      added the new select-sso-provider enum value to the /// response property for the response status

    • warning

      added the new server-create enum value to the /// response property for the response status

    • warning

      added the new server-fetch enum value to the /// response property for the response status

    • warning

      added the new server-update enum value to the /// response property for the response status

    • warning

      added the new share enum value to the /// response property for the response status

    • info

      added the non-success response with the status

    • info

      added the optional property /// to the response with the status

  • 6332d0d0926aRevision changes
    • info

      added the optional property /// to the response with the status