Skip to main content
This changelog tracks notable changes to the 1Password Events API and provides information about when changes were made and what changed.

​
Summary of changes

* Breaking changes are backwards-incompatible changes that require an upgrade to use. When breaking changes are released, we’ll continue to support previous versions of the API and you can choose when to upgrade your API version.
​
version 1.4.1
Added a new account_UUID property to the introspect endpoint (/api/v2/auth/introspect).You can now confirm the account a bearer token was issued from. This is particularly relevant to managed service providers (MSPs) that manage multiple accounts.
​
version 1.4.0
Added new V2 endpoints with external user and MSP functionality:
  • POST /api/v2/signinattempts
  • POST /api/v2/itemusages
Changes include:
  • New SignInAttemptV2 schema:
    • Added account_uuid field
    • Added federated sign-in type
    • Uses enhanced UserV2 schema
  • New ItemUsageV2 schema:
    • Added account_uuid field
    • Uses enhanced UserV2 schema
  • New SignInAttemptUserTypes enum for user type classification

​
Breaking changes

V2 endpoints introduce new required fields and response structures. If upgrading from V1:
  • Response schemas include new required fields
  • User objects now include type classification
  • New enums added for MSP functionality

​
Migration impact

V1 endpoints continue to be supported. Migration to V2 endpoints is only required if you’re an MSP provider and you need to access MSP-related event data for your account or the accounts of your managed companies.New integrations can use V2 endpoints regardless of MSP needs.
​
version 1.3.0
Added new V2 audit events endpoint with MSP support:
  • POST /api/v2/auditevents
Changes include:
  • New AuditEventV2 schema:
    • Added actor_type field
    • Added actor_account_uuid field
    • Added account_uuid field
  • Added AuditEventActorTypes enum
  • Added new actions:
    • expire
    • launchi
    • unlink
  • Added mngdacc object type for managed accounts
​
version 1.2.0
  • Added “cred” object type for passkey authentication
  • Fixed latitude field name in Location schema
​
version 1.2.0
Enhanced AuditEvent schema with detailed user information:
  • Added actor_details
  • Added object_details
  • Added aux_details
​
version 1.2.0
  • Added audit events endpoint (/api/v1/auditevents)
  • Added new schemas:
    • AuditEvent
    • AuditEventItems
    • AuditEventActions
    • AuditEventObjectTypes
    • Session
​
version 1.2.0
  • Added Location object to sign-in attempts and item usage events:
    • country
    • region
    • city
    • longitude
    • latitude
  • Added new item usage actions:
    • select-sso-provider
    • enter-item-edit-mode
​
version 1.1.0
  • Added 500 Internal Server Error response to all endpoints
​
version 1.1.0
Added V2 introspection endpoint:
  • New introspection endpoint (/api/v2/auth/introspect)
  • V1 endpoint marked as deprecated
  • Added IntrospectionV2 schema with consistent naming
​
Version 1.0.0
Initial public release of the 1Password Events API, including:
  • Introspection endpoint
  • JWT authentication
  • Item usage endpoint
  • Sign-in attempts endpoint
  • Cursor-based pagination

Related topics

Events API beta roadmap and changelogGet started with the 1Password Events API (beta)1Password Events API