1Password Events API changelog

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

Summary of changes

Version	Date	Type	Description	Details
1.4.0	November 2024	New feature	Added V2 endpoints for sign-in attempts and item usage with external user and MSP support (Breaking change *)	View details
1.3.0	September 2024	New feature	Added V2 audit events endpoint with external user and MSP support (Breaking change *)	View details
1.2.0	November 2023	New feature	Added passkey credential support to audit events	View details
1.2.0	August 2023	Improvement	Enhanced user details in audit event responses	View details
1.2.0	November 2022	New feature	Added audit events endpoint and reporting capabilities	View details
1.2.0	March 2022	Improvement	Added geolocation info and SSO actions	View details
1.1.0	September 2021	Improvement	Added internal server error handling	View details
1.1.0	August 2021	New feature	Added V2 introspection endpoint (Breaking change *)	View details
1.0.0	July 2021	Initial release	Initial 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.

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 /api/v2/auth/introspect endpoint
• 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