Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

1Password Item Usages API

Retrieve information about items in shared vaults that have been modified, accessed, or used, including the user who accessed the item, when it was accessed, and the vault where the item is stored.

1Password Item Usages API is one of 11 APIs that 1Password publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 5 JSON Schema definitions.

Tagged areas include Item Usages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 5 JSON Schemas.

This API exposes 1 operation across 1 path, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 1.8.1.

Requests are made against a single base URL, http://localhost:8080.

1 operations 1 paths 7 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.8.1
Base URL
http://localhost:8080
Authentication
HTTP Bearer
License
Terms of Service
Resource Areas
1

Authentication & Security 1

1Password Item Usages API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — A Connect server access token generated from 1Password. Each request must include this token in the Authorization header.

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Item Usages 1

Retrieve information about items in shared vaults that have been modified, accessed, or used, including the user who accessed the item, when it was accessed, and the vault where t…

POST
/api/v2/itemusages
1Password List Item Usages
listItemUsagesV2 body → 200401429

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are ItemUsage (9 properties), EventClient (7 properties), EventLocation (5 properties), EventUser (3 properties). Each schema is shown below with its type and property counts.

Error
object
Represents an error response from the Events API.
2 properties
EventRequest
object
The request body for fetching events. Must include either a cursor string from a previous response to continue pagination, or a ResetCursor object to start fet…
3 properties
ItemUsageResponse
object
The response containing item usage records and a cursor for pagination.
3 properties
EventClient
object
Information about the client application used in an event.
7 properties
ItemUsage
object
Represents a record of an item in a shared vault being accessed, modified, or used.
9 properties
EventUser
object
Represents a user involved in an event.
3 properties
EventLocation
object
Geographic location information associated with an event.
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

1password-item-usages-api-openapi.yml Raw ↑

Other APIs 1Password publishes across the network.

1Password Accounts API
1Password Activity API
1Password Audit Events API
1Password Files API
1Password Health API
1Password Introspection API
1Password Items API
1Password Metrics API
1Password Sign-In Attempts API
1Password Vaults API