Actions223
- Reports Actions
- Compliance Actions
- Jobs Actions
- Active Directory Actions
- Get Retrieve Ad Roles
- Get Retrieve Ad User Licenses
- Get Retrieve Azure Licenses
- Get Retrieve Azure Ad Logs
- Get Retrieve Azure Secure Score
- Get Retrieve Ad Password Policies
- Get Retrieve Ad Groups View
- Get Retrieve Ad Ous View
- Get Retrieve Ad Gpos View
- Get Retrieve Ad Computers View
- Get Retrieve Ad Users View
- Get Retrieve Ad Domain Details
- Get Retrieve Ad Gpos Details
- Get Retrieve Get Ous Details
- Get Retrieve Get Groups Details
- Get Retrieve Ad Group Users
- Get Retrieve Ad Group Computers
- Get Retrieve Get User Details
- Get Retrieve Get Computer Details
- Get Retrieve Ad Roles Details
- Get Retrieve Ad Roles Member
- Get Retrieve Ad Basic Info
- Audit Log Actions
- Ad Audit Actions
- Scheduler Actions
- Application Baseline Actions
- Get Retrieve Application Baseline Rules
- Get Retrieve Application Baseline Rule
- Post Create Application Baseline Rule
- Patch Update Application Baseline Rule
- Delete Delete Application Baseline Rule
- Get Retrieve App Baseline Plan Assets
- Get Retrieve App Baseline Plan Asset
- Get Retrieve App Baseline Plan Company
- Get Retrieve App Baseline Plan Global
- Attack Surface Actions
- Backup Software Actions
- EDR Actions
- Tags Actions
- PII Actions
- External Scan Actions
- Settings Actions
- Compliance Assessment Actions
- Auth Actions
- Company Actions
- Agent Actions
- Credentials Actions
- Get Retrieve Credentials
- Get Retrieve Credential
- Post Create Credential
- Patch Update Credential
- Delete Delete Credential
- Get Retrieve Agent Credentials Mapping
- Get Retrieve Agent Credential Mapping
- Post Create Agent Credential Mapping
- Patch Update Agent Credential Mapping
- Delete Delete Agent Credential Mapping
- Asset Actions
- Get Retrieve Records
- Get Retrieve Assets
- Get Retrieve Asset
- Post Create Asset
- Patch Update Asset
- Delete Delete Asset
- Get Retrieve Asset Stats
- Get Retrieve Asset Stat
- Get Retrieve Asset View
- Get Retrieve Cron Jobs
- Get Retrieve Kernel Modules
- Get Retrieve Suid Permissions
- Get Retrieve Ufw Firewall Rules
- Get Retrieve Selinux Settings
- Get Retrieve Asset Iptables Rules
- Get Retrieve Asset Users
- Get Retrieve Asset Processes Running
- Get Retrieve Asset Services
- Get Retrieve Asset Patches Info
- Get Retrieve Asset Firewall Rules
- Get Retrieve Asset Registry Misconfiguration
- Get Retrieve Asset Open Ports
- Get Retrieve Notification Tickets View
- Get Retrieve System Events View
- Discovery Settings Actions
- Get Retrieve Discovery Settings
- Get Retrieve Discovery Setting
- Post Create Discovery Setting
- Patch Update Discovery Setting
- Delete Delete Discovery Setting
- Get Retrieve Agent Discoverysettings Mapping
- Get Retrieve Agent Discoverysetting Mapping
- Post Create Agent Discoverysetting Mapping
- Patch Update Agent Discoverysetting Mapping
- Delete Delete Agent Discoverysetting Mapping
- Asset Data Actions
- Get Retrieve Asset Compliance Report Card
- Get Retrieve Asset Firewall Policy
- Get Retrieve Asset Installed Drivers
- Get Retrieve Asset Installed Driver
- Get Retrieve Asset Interface
- Get Retrieve Asset Msdt
- Get Retrieve Asset Ports
- Get Retrieve Asset Port
- Get Retrieve Asset Security Report Data
- Get Retrieve Asset Security Report Datum
- Get Retrieve Asset Shares
- Get Retrieve Asset Share
- Get Retrieve Asset Storages
- Get Retrieve Asset Storage
- Get Retrieve Asset Unqouted Services
- Get Retrieve Asset Unqouted Service
- Get Retrieve Asset User Shares
- Get Retrieve Asset User Share
- Get Retrieve Asset Video Info
- Get Retrieve Asset Windows Reboot Required
- Get Retrieve Asset Window Reboot Required
- Get Retrieve Bios Info
- Get Retrieve Bio Info
- Get Retrieve Browser Extensions
- Get Retrieve Browser Extension
- Get Retrieve Ciphers View
- Get Retrieve Cipher View
- Get Retrieve Windows Protection Status
- Get Retrieve Window Protection Status
- Vulnerabilities Actions
- Firewall Actions
- Get Retrieve Firewall Groups
- Get Retrieve Firewall Group
- Get Retrieve Firewall Interfaces
- Get Retrieve Firewall Interface
- Get Retrieve Firewall License
- Get Retrieve Firewall Rules
- Get Retrieve Firewall Rule
- Get Retrieve Firewall Users
- Get Retrieve Firewall User
- Get Retrieve Firewall Zones
- Get Retrieve Firewall Zone
- Integration Actions
- Get Retrieve Integration Credentials
- Get Retrieve Integration Credential
- Post Create Integration Credential
- Patch Update Integration Credential
- Delete Delete Integration Credential
- Get Retrieve Integration Rules
- Get Retrieve Integration Rule
- Post Create Integration Rule
- Patch Update Integration Rule
- Delete Delete Integration Rule
- Get Retrieve Company Mappings
- Get Retrieve Company Mapping
- Post Create Company Mapping
- Patch Update Company Mapping
- Delete Delete Company Mapping
- Event Set Actions
- Ticket Template Actions
Overview
This node operation, "Get Retrieve Asset Shares," is designed to fetch shared asset data from an external service. It allows users to retrieve information about asset shares associated with a particular user by specifying the user ID and optional query parameters to filter, sort, or paginate the results.
Common scenarios where this node would be beneficial include:
- Retrieving all asset shares for a specific user to display or process in workflows.
- Filtering asset shares based on conditions such as date ranges or status.
- Paginating through large sets of asset share records by skipping and limiting the number of returned entries.
- Ordering the retrieved asset shares by specified fields.
Practical example: A workflow that monitors asset sharing activity could use this node to pull the latest shares for a user, filter them by certain criteria, and then trigger notifications or further processing based on the retrieved data.
Properties
| Name | Meaning |
|---|---|
| X USER ID | The User ID for whom the asset shares are being retrieved. This is required and sent as a header named X-USER-ID. |
| Additional Query Parameters | Optional parameters to refine the query: - Condition: A string to specify query conditions (e.g., filters). - Skip: Number of records to skip (for pagination). - Limit: Maximum number of records to return. - Order By: Field(s) to order the results by. |
Output
The node outputs JSON data representing the retrieved asset shares. Each item in the output corresponds to an asset share record fetched from the external service. The structure typically includes details about the asset share such as identifiers, metadata, and any relevant attributes provided by the API.
If the external service supports binary data related to asset shares (e.g., documents or images), the node would handle it accordingly, but based on the provided code and properties, the primary output is JSON data.
Dependencies
- Requires an API key credential for authenticating requests to the external service.
- The base URL for the API is configured via credentials.
- Uses HTTP headers and query parameters to communicate with the API endpoint.
- Depends on the
@avantguardllc/n8n-openapi-nodepackage and an OpenAPI specification (openapi.json) bundled with the node for request building.
Troubleshooting
- Missing or invalid X USER ID header: Since the user ID is required, omitting it or providing an incorrect value will likely cause authentication or authorization errors. Ensure the user ID is correctly set.
- Invalid query parameters: Providing malformed or unsupported values in additional query parameters (e.g., non-numeric skip/limit) may result in API errors. Validate inputs before execution.
- API connectivity issues: Network problems or incorrect base URL configuration can prevent successful API calls. Verify credentials and network access.
- Empty or unexpected responses: If no asset shares match the query, the output may be empty. Adjust query parameters or verify data availability.
Links and References
- n8n Documentation
- OpenAPI Specification
- Relevant API documentation for the external asset sharing service (not provided here).