This folder contains a code snippet demonstrating how to use the 1Password Python SDK for performing various operations on 1Password vaults and items. Specifically, the example showcases how to:

• Authenticate with the 1Password API using a service account token.
• List available vaults and items within those vaults.
• Retrieve a specific secret and resolve a one-time password (TOTP).
• Create a new item in a vault with multiple fields and tags.
• Update an existing item by modifying its fields and adding a new website.
• Generate different types of passwords (PIN, memorable, and random).
• Share an item with valid recipients and create a shareable link.
• Archive or delete items from the vault.
• Create and manage SSH key items.
• Create and manage document items, including replacing and reading documents.
• Create and manage file field items by attaching and deleting files.

1. Clone the repository and follow the steps to get started.
2. Ensure that you have a valid service account token by exporting it as an environment variable:

   export OP_SERVICE_ACCOUNT_TOKEN="<your token>"

3. Export the vault UUID you wish to interact with as an environment variable:

   export OP_VAULT_ID="<your vault uuid>"

To run the example file, navigate to project root directory and run:

python example/example.py

When running the example, the terminal will display:

• A list of vaults and items.
• Retrieved secrets and TOTP codes.
• Details of newly created and updated items.
• Generated passwords (PIN, memorable, random).
• A shareable link for shared items.
• SSH key attributes like public key and fingerprint.
• Document content after replacing the file.
• A list of file field items and file deletions.

These outputs show the results of vault and item operations, password generation, item sharing, and management of SSH and document items.