1Password

Interact with 1Password API

Actions8

Overview

The node integrates with the 1Password API to manage items stored within vaults. Specifically, the "List Items" operation under the "Item" resource retrieves a list of items from a specified vault. This is useful for workflows that need to access or process multiple 1Password entries programmatically, such as syncing credentials, auditing stored secrets, or automating item management.

Practical examples include:

Fetching all login credentials stored in a particular vault to update an external password manager.
Filtering items by title or tag to find specific secrets for automated deployment scripts.
Integrating 1Password data into reporting or compliance tools.

Properties

Name	Meaning
Vault UUID	The unique identifier (UUID) of the vault from which to list items.
Filter	Optional string to filter items by their title or tag. If provided, only matching items are returned.

Output

The node outputs a JSON array of items retrieved from the specified vault. Each item typically includes details such as its title, tags, and other metadata as defined by the 1Password API. The output does not include binary data.

Example structure of each item in the json output might look like:

{
  "id": "string",
  "title": "string",
  "tags": ["string"],
  "category": "string",
  "vaultId": "string",
  ...
}

Dependencies

Requires an active connection to the 1Password API via an API key credential.
The node expects the base URL of the 1Password API to be configured in the credentials.
No additional external dependencies beyond the 1Password API.

Troubleshooting

Common issues:
- Invalid or missing Vault UUID will cause the request to fail; ensure the correct vault identifier is used.
- Incorrect API credentials or expired tokens will result in authentication errors.
- Using filters that do not match any items will return an empty list, which is expected behavior.
Error messages:
- Authentication errors usually indicate invalid API keys or misconfigured credentials.
- "Vault not found" errors suggest the Vault UUID is incorrect or the user lacks access permissions.
- Network or timeout errors may occur if the 1Password API is unreachable; verify network connectivity.