Release 0.4.1b1

1Password Python SDK v0.4.1b1

NEW

• 1Password Environment access: The SDK can now read variables from a 1Password Environment.

Release 0.4.0

1Password Python SDK v0.4.0

NEW

• Desktop App integration: The SDK can now authenticate via an authorization prompt from the 1Password app.
• Vault CRUDL: You can now fully manage 1Password vaults with the SDK, including creating, reading, updating, deleting and listing.
• Vault group permission management operations: You can now grant, update and revoke group access to vaults using grantGroupPermissions, updateGroupPermissions, and revokeGroupPermissions functions.
• Item batch management: You can now retrieve, create, update and delete items in batch, enabling more scalable item management.

Release 0.4.0b2

1Password Python SDK v0.4.0b2

NEW

• Vault group permission management operations: You can now grant, update and revoke group access to vaults using grant_group_permissions, update_group_permissions, and revoke_group_permissions functions.
• Desktop App integration on Windows: The SDK can now authenticate via an authorization prompt from the 1Password app on Windows as well. Now all major desktop OSs support this feature.

FIXED

• Vault listing with additional parameters: vaults.list no longer errors when additional parameters are provided.
• Handling locked 1Password app state: When the 1Password app gets locked after the SDK client is authenticated, it will now automatically re-authenticate.

Release 0.3.2

1Password Python SDK v0.3.2

FIXED

• The client.secrets.resolve_all() SDK function now only sources secrets from active items.

Release 0.4.0b1

1Password Python SDK v0.4.0b1

NEW

• The SDK can now authenticate with the Desktop App.
• Vault get, get_overview as well as new options for vault list are now available.
• Item batch operations are now available.
• The Groups API has been introduced.

Release 0.3.1

1Password Python SDK v0.3.1

NEW

• VaultOverview now includes created_at and updated_at fields that show when the vault was created and last updated.

Release 0.3.0

1Password Python SDK v0.3.0

NEW

• Support for item states: You can now fetch an item's state using the SDK. ItemOverview exposes one of two states: Active or Archived.
  • Active: An item located inside a vault. (Default)
  • Archived: An item that has been moved to the Archive. 1Password doesn't include archived items in search results or suggest them when you fill in apps and browsers. You can keep archived items as long as you'd like.
• Filtering listed items by state: You can now filter the results of the item list function by item state.

FIXED

• Deleting Archived Items: The SDK now supports deleting items from the archive.

⚠️ BREAKING CHANGES ⚠️

This release contains breaking changes for two functions in the Python SDK.

Vault listing

• The function name has changed from list_all to list. To use this in your code, replace:

vaults = await client.vaults.list_all(vault_id)

with:

vaults = await client.vaults.list(vault_id)

• The return type of the vault listing function has changed from SDKIterator[VaultOverview] to List[VaultOverview]. To use this in your code, replace:

async for vault in vaults:
    # using vault overview

with:

for vault in vaults:
    # using vault overview

Item listing

• The function name has changed from ListAll to List. To use this in your code, replace:

overviews = await client.items.list_all(vault_id)

with:

overviews = await client.items.list(vault_id, ItemListFilter(
                content=ItemListFilterByStateInner(
                    active=True,
                    archived=True,
                )
            ))

• The return type of the item listing function has changed from SDKIterator[ItemOverview] to List[ItemOverview]. To use this in your code, replace:

async for overview in overviews:
    # using item overview

with:

for overview in overviews:
    # using item overview

This does not affect any code that's already deployed, and will not take effect in your codebase until you choose to update to version 0.3.0 or later of the 1Password Python SDK.

Release 0.2.1

1Password Python SDK v0.2.1

NEW

• CreatedAt and UpdatedAt item metadata: Items and item overviews now expose attributes with their creation and last edit times.
• Resolving secrets in bulk: With the client.secrets.resolveAll function, the SDK is now able to resolve multiple secrets at once, improving the performance of the operation.

IMPROVED

• Support for new field types: Items with Address and Date fields can now be created, retrieved, and edited using the 1Password SDK.
• Item sharing for attachments and documents: Items with files attached can now be shared.
• Adding custom fields in sections automatically: If a custom field has no specified section, the SDKs now automatically add the custom field to an empty section within the item, creating it if necessary.
• Tags in item overviews: The return type of items.list_all now also contains the item tags.
• Broader item editing capabilities: You can now use the items.put function with more item types, including those with fields that are not directly editable through the SDK, like legacy fields, or passkeys.

FIXED

• Improvements to resolving secret references:
  • Archived items are no longer used for secret references.
  • When multiple sections match a section query when resolving secret references, the SDKs now look through the fields in all matching sections instead of erroring.

Release 0.2.0

1Password Python SDK v0.2.0

NEW

• File Support: You can now create Document items, attach files to items, delete files from items, and read file contents using the SDK.

IMPROVED

• Read files using secret references: You can now resolve secret references that point to files attached to 1Password items.
• Read SSH keys in Open SSH format: You can now use a secret reference to fetch a private key in OpenSSH format. For example: op://vault/<SSH item>/private key?ssh-format=openssh
• Support for more item field types: You can now create, retrieve, and edit items containing SSH keys, Month-Year and Menu-type fields using the SDK.
• Read more field types using secret references: You can now resolve secret references that point to information stored in Date, Month/Year, Address, and Reference field types.
• Improved error messages: The error messages returned by the SDK were improved to be more clear and actionable.

Release 0.1.7

1Password Python SDK v0.1.7

IMPROVED:

• The SDK now returns an error with a custom type when it hits the rate limit of the 1Password servers.

FIXED:

• Using an SDK client in a long-running process no longer causes 401 server responses.