Get started with 1Password SDKs1Password SDKs 0.2.1 is now available. 🎉
Version 0.2.1 introduces CreatedAt and UpdatedAt item metadata, support for resolving secrets in bulk, support for Address and Date field types, and more.
See what’s new in Go, JavaScript, or Python.
CreatedAt and UpdatedAt item metadata: Items and item overviews now expose attributes with their creation and last edit times.- Resolve secrets in bulk: With the
client.secrets.resolveAll function, the SDKs are now able to resolve multiple secrets at once, improving the performance of the operation. - Support for new field types: Items with
Address and Date fields can now be created, retrieved, and edited using the 1Password SDKs. - Item sharing for attachments and documents: Items with files attached can now be shared using the
client.items.shares functions. - 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.listAll 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. - Archived items are no longer used when resolving 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.
- You can now create Document items, attach files to items, delete files from items, and read file contents using the SDKs.
- You can now resolve secret references that point to files attached to 1Password items.
- 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 - You can now create, retrieve, and edit items containing SSH keys, Month-Year, and Menu-type fields using the SDKs.
- You can now resolve secret references that point to information stored in Date, Month/Year, Address, and Reference field types.
- The error messages returned by the SDK are now more clear and actionable.
- The SDK now returns an error with a custom type when it hits the rate limit of the 1Password servers.
- Using an SDK client in a long-running process no longer causes 401 server responses.
- You can now create an item sharing link with the new
client.Items.Shares API. - You can now move items to the archive with the new
client.Items.Archive(vault_uuid, item_uuid) function. - You can now read, create, and edit items with a notes field with
item.Notes. - You can now retrieve an SSH key’s public key, key type, and fingerprint with
client.Secrets.Resolve. - You can now read, create, and edit items with
Email (email addresses) and Reference (ID references to other 1Password items) type fields. - When developing with the Python SDK, the functions now show type hints on their parameters and return types.
- We’ve fixed item CRUD operations for the password item category. Creating or editing a password item no longer leads to a panic in the Go SDK.
- We’ve improved field matching logic for secret references. Retrieving a field from the item’s default field section is now possible even if there is an identically named field in one of the item’s named sections.
- You can now generate random, PIN, and memorable passwords using the onepassword.Secrets.GeneratePassword function.
- Creating and editing an item now sets the subtitle correctly, which is visible in the item preview in all client apps.
- You can now retrieve, create, and edit items containing credit card numbers.
- You can now check that a secret reference is formatted correctly without having to resolve it or even authenticate, using the
ValidateSecretReference function.
- You can now create, get, and edit the websites where 1Password autofills credentials from Login and Password items.
- You can now create, get, and edit tags within your 1Password items.
- You can now fetch one-time password codes with the
secrets.resolve function, using a secret reference for the TOTP field in your item. For example: op://vault/item/field?=attribute=totp. - Item creation now only requires specifying the vault ID, item category, and item title.
- The SDKs now fully support optional values. You no longer need to manually set
details: None or section: None when instantiating ItemCreateParams. - The Python SDK is now published on PyPI. You can now install the Python SDK with
pip install onepassword-sdk.
Developer tools
