1Password icon

1Password

Interact with 1Password API

Overview

This node integrates with the 1Password API to retrieve detailed information about files stored within a 1Password vault. Specifically, the "Get File Details" operation under the "File" resource fetches metadata and optionally inline content of a specified file. This is useful for workflows that need to access or process secure files managed in 1Password, such as retrieving attachments, documents, or other file types stored alongside credentials or items.

Practical examples include:

  • Automating backup or synchronization of files stored in 1Password.
  • Extracting file metadata or content for auditing or reporting purposes.
  • Integrating 1Password file data into other systems or processes without manual download.

Properties

Name Meaning
Vault UUID The unique identifier of the vault containing the file.
Item UUID The unique identifier of the item within the vault that holds the file.
File UUID The unique identifier of the specific file to retrieve details for.
Inline Content Boolean flag indicating whether to include the file's content inline in the response (true) or not (false).

Output

The node outputs JSON data representing the file details retrieved from 1Password. This includes metadata such as file name, size, type, and potentially the file content itself if "Inline Content" is enabled.

If the file content is included inline, it will be part of the JSON output, typically encoded (e.g., base64). The node may also support binary output for the file content, allowing downstream nodes to handle the file as binary data (e.g., saving to disk or uploading elsewhere).

Dependencies

  • Requires an API key credential for authenticating with the 1Password API.
  • The node configuration must include the base URL for the 1Password API endpoint.
  • Network access to the 1Password API service is necessary.

Troubleshooting

  • Invalid UUIDs: Errors may occur if the provided Vault UUID, Item UUID, or File UUID are incorrect or do not exist. Verify these identifiers in your 1Password account.
  • Authentication errors: Ensure the API key credential is valid and has sufficient permissions to access the requested vault and file.
  • Permission issues: The authenticated user or API token must have access rights to the vault and item; otherwise, the request will fail.
  • Inline content size limits: Retrieving large files inline might cause performance issues or timeouts. Consider disabling inline content and handling files as binary data if supported.
  • Network errors: Check connectivity and firewall settings if requests to the 1Password API fail.

Links and References

Discussion