generated: '2026-06-20'
method: derived
source: openapi/1password-connect-openapi.yml, openapi/1password-events-openapi.yml, openapi/1password-partnership-openapi.yml
entities:
  # --- Connect Server API ---
  - name: Vault
    api: connect
    id_field: id
    description: A collection of items the Connect server is authorized to access.
  - name: Item
    api: connect
    id_field: id
    description: A secret record (login, password, note, etc.) stored in a vault.
  - name: FullItem
    api: connect
    description: An item with its full field/section/file detail.
  - name: Field
    api: connect
    description: A single field on an item (value, type, generator recipe).
  - name: Section
    api: connect
    description: A named grouping of fields on an item.
  - name: File
    api: connect
    id_field: id
    description: A file attached to an item.
  - name: APIRequest
    api: connect
    description: A record of an API request made to the Connect server (activity log).
  - name: ServerHealth
    api: connect
    description: Health/status of the Connect server.
  # --- Events API ---
  - name: SignInAttempt
    api: events
    description: A record of a sign-in attempt to a 1Password account.
  - name: ItemUsage
    api: events
    description: A record of an item being accessed/modified/used in a shared vault.
  - name: AuditEvent
    api: events
    description: A record of an administrative action within the account.
  - name: EventUser
    api: events
    description: The user associated with an event.
  - name: EventClient
    api: events
    description: The client/app associated with an event.
  - name: EventLocation
    api: events
    description: Geolocation associated with an event.
  - name: TokenIntrospection
    api: events
    description: Metadata about the bearer token (features, permissions, account_uuid).
  # --- Partnership API ---
  - name: Account
    api: partnership
    id_field: accountUid
    description: A partner billing account for a 1Password individual/family customer.
relationships:
  - from: Vault
    to: Item
    type: has_many
    via: vaultUuid
  - from: Item
    to: File
    type: has_many
    via: itemUuid
  - from: Item
    to: Field
    type: has_many
    via: item.fields
  - from: Item
    to: Section
    type: has_many
    via: item.sections
  - from: Field
    to: Section
    type: belongs_to
    via: section.id (SectionRef)
  - from: SignInAttempt
    to: EventUser
    type: has_one
    via: target_user
  - from: ItemUsage
    to: EventUser
    type: has_one
    via: used_by
  - from: ItemUsage
    to: Vault
    type: belongs_to
    via: vault_uuid
  - from: AuditEvent
    to: EventUser
    type: has_one
    via: actor
  - from: AuditEvent
    to: EventClient
    type: has_one
    via: client
  - from: SignInAttempt
    to: EventLocation
    type: has_one
    via: location