---
title: "Changes to Retrieves events for each usage of an item stored in a shared vault within a 1Password account"
method: POST
path: "/api/v1/itemusages"
---

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

`POST /api/v1/itemusages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-07-13** `359da8b22780`: 1 breaking, 10 warning, 2 info
- **2022-05-22** `6332d0d0926a`: 1 info

## Changes

- **2026-07-13** `359da8b22780`: 1 breaking, 10 warning, 2 info
  - the `allOf[subschema #1]/items/items/action` response's property type changed from no type to `string` for status `200`
  - added the new `enter-item-edit-mode` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `export` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `fill` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `reveal` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `secure-copy` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `select-sso-provider` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `server-create` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `server-fetch` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `server-update` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the new `share` enum value to the `allOf[subschema #1]/items/items/action` response property for the response status `200`
  - added the non-success response with the status `500`
  - added the optional property `allOf[subschema #1]/items/items/location` to the response with the `200` status
- **2022-05-22** `6332d0d0926a`: 1 info
  - added the optional property `allOf[subschema #1]/items/items/action` to the response with the `200` status

---

[Operation](https://skmtc.dev/1password/apis/events-api/docs/api/v1/itemusages/post.md) - [API](https://skmtc.dev/1password/apis/events-api.md) - [Page](https://skmtc.dev/1password/apis/events-api/changes/api/v1/itemusages/post)