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

VersionDateTypeDescriptionDetails
1.4.1September 2025ImprovementAdded an account UUID property to the introspect response object.View details
1.4.0November 2024New featureAdded V2 endpoints for sign-in attempts and item usage with external user and MSP support. (Breaking change *)View details
1.3.0September 2024New featureAdded V2 audit events endpoint with external user and MSP support. (Breaking change *)View details
1.2.0November 2023New featureAdded passkey credential support to audit events.View details
1.2.0August 2023ImprovementEnhanced user details in audit event responses.View details
1.2.0November 2022New featureAdded audit events endpoint and reporting capabilities.View details
1.2.0March 2022ImprovementAdded geolocation info and SSO actions.View details
1.1.0September 2021ImprovementAdded internal server error handling.View details
1.1.0August 2021New featureAdded V2 introspection endpoint. (Breaking change *)View details
1.0.0July 2021Initial releaseInitial public release of the 1Password Events API.View details
* 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.
​
September 2025
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.
​
November 2024
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.
​
September 2024
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
​
November 2023
version 1.2.0
  • Added “cred” object type for passkey authentication
  • Fixed latitude field name in Location schema
​
August 2023
version 1.2.0
Enhanced AuditEvent schema with detailed user information:
  • Added actor_details
  • Added object_details
  • Added aux_details
​
November 2022
version 1.2.0
  • Added audit events endpoint (/api/v1/auditevents)
  • Added new schemas:
    • AuditEvent
    • AuditEventItems
    • AuditEventActions
    • AuditEventObjectTypes
    • Session
​
March 2022
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
​
September 2021
version 1.1.0
  • Added 500 Internal Server Error response to all endpoints
​
August 2021
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
​
July 2021
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