Actions222
- Application Baseline Actions
- Attack Surface Actions
- Backup Software Actions
- EDR Actions
- Tags Actions
- PII Actions
- External Scan Actions
- Settings Actions
- Compliance Assessment Actions
- Reports Actions
- Compliance Actions
- Jobs Actions
- Active Directory Actions
- Retrieve Ad Roles
- Retrieve Ad User Licenses
- Retrieve Azure Licenses
- Retrieve Azure Ad Logs
- Retrieve Azure Secure Score
- Retrieve Ad Password Policies
- Retrieve Ad Groups View
- Retrieve Ad Ous View
- Retrieve Ad Gpos View
- Retrieve Ad Computers View
- Retrieve Ad Users View
- Retrieve Ad Domain Details
- Retrieve Ad Gpos Details
- Retrieve Get Ous Details
- Retrieve Get Groups Details
- Retrieve Ad Group Users
- Retrieve Ad Group Computers
- Retrieve Get User Details
- Retrieve Get Computer Details
- Retrieve Ad Roles Details
- Retrieve Ad Roles Member
- Retrieve Ad Basic Info
- Audit Log Actions
- Ad Audit Actions
- Asset Data Actions
- Retrieve Bios Info
- Retrieve Bio Info
- Retrieve Browser Extensions
- Retrieve Browser Extension
- Retrieve Ciphers View
- Retrieve Cipher View
- Retrieve Windows Protection Status
- Retrieve Window Protection Status
- Retrieve Asset Compliance Report Card
- Retrieve Asset Firewall Policy
- Retrieve Asset Installed Drivers
- Retrieve Asset Installed Driver
- Retrieve Asset Interface
- Retrieve Asset Msdt
- Retrieve Asset Ports
- Retrieve Asset Port
- Retrieve Asset Security Report Data
- Retrieve Asset Security Report Datum
- Retrieve Asset Shares
- Retrieve Asset Share
- Retrieve Asset Storages
- Retrieve Asset Storage
- Retrieve Asset Unqouted Services
- Retrieve Asset Unqouted Service
- Retrieve Asset User Shares
- Retrieve Asset User Share
- Retrieve Asset Video Info
- Retrieve Asset Windows Reboot Required
- Retrieve Asset Window Reboot Required
- Vulnerabilities Actions
- Firewall Actions
- Integration Actions
- Retrieve Integration Credentials
- Retrieve Integration Credential
- Create Integration Credential
- Update Integration Credential
- Delete Integration Credential
- Retrieve Integration Rules
- Retrieve Integration Rule
- Create Integration Rule
- Update Integration Rule
- Delete Integration Rule
- Retrieve Company Mappings
- Retrieve Company Mapping
- Create Company Mapping
- Update Company Mapping
- Delete Company Mapping
- Event Set Actions
- Ticket Template Actions
- Scheduler Actions
- Credentials Actions
- Asset Actions
- Retrieve Records
- Retrieve Assets
- Retrieve Asset
- Create Asset
- Update Asset
- Delete Asset
- Retrieve Asset Stats
- Retrieve Asset Stat
- Retrieve Asset View
- Retrieve Cron Jobs
- Retrieve Kernel Modules
- Retrieve Suid Permissions
- Retrieve Ufw Firewall Rules
- Retrieve Selinux Settings
- Retrieve Asset Iptables Rules
- Retrieve Asset Users
- Retrieve Asset Processes Running
- Retrieve Asset Services
- Retrieve Asset Patches Info
- Retrieve Asset Firewall Rules
- Retrieve Asset Registry Misconfiguration
- Retrieve Asset Open Ports
- Retrieve Notification Tickets View
- Retrieve System Events View
- Discovery Settings Actions
- Retrieve Discovery Settings
- Retrieve Discovery Setting
- Create Discovery Setting
- Update Discovery Setting
- Delete Discovery Setting
- Retrieve Agent Discoverysettings Mapping
- Retrieve Agent Discoverysetting Mapping
- Create Agent Discoverysetting Mapping
- Update Agent Discoverysetting Mapping
- Delete Agent Discoverysetting Mapping
- Auth Actions
- Company Actions
- Agent Actions
Overview
This node operation, Retrieve Report Jobs View, is designed to fetch a list or view of report jobs from the Connect Secure API. It allows users to query report job data with flexible filtering, pagination, and sorting options. This is useful in scenarios where you need to monitor, audit, or analyze report generation jobs programmatically within an automation workflow.
Practical examples include:
- Retrieving recent report jobs for a specific user.
- Filtering report jobs based on custom conditions (e.g., status, date range).
- Paginating through large sets of report jobs.
- Sorting report jobs by creation date or other fields.
Properties
| Name | Meaning |
|---|---|
| X USER ID | User Id header value to identify the user making the request. |
| Condition | Query condition string to filter report jobs based on specific criteria. |
| Skip | Number of records to skip for pagination purposes. |
| Limit | Maximum number of records to return. |
| Order By | Field(s) to order the results by, e.g., "createdAt desc" or "status asc". |
Output
The node outputs JSON data representing the retrieved report jobs view. The structure typically includes an array of report job objects matching the query parameters. Each object contains details about individual report jobs such as job id, status, timestamps, and other metadata relevant to the report job.
If the API supports binary data for reports or attachments, this node would handle it accordingly, but based on the provided code and properties, the output focuses on JSON data describing report jobs.
Dependencies
- Requires an API key credential for authenticating with the Connect Secure API.
- The node depends on the Connect Secure API endpoint that provides report job views.
- No additional external dependencies are indicated beyond the bundled OpenAPI client and lodash utility.
Troubleshooting
- Missing or invalid X USER ID: The API requires a valid user ID header; ensure this is correctly set.
- Invalid query condition syntax: If the condition string is malformed, the API may reject the request or return no results.
- Pagination issues: Setting
skiporlimitincorrectly might result in empty responses or incomplete data. - Order By errors: Using unsupported fields in the order_by parameter can cause API errors.
- Authentication failures: Ensure the API key credential is valid and has sufficient permissions.
Common error messages will likely relate to HTTP 4xx or 5xx responses indicating authentication failure, bad requests due to invalid parameters, or server errors. Checking the exact API response message will help diagnose these issues.
Links and References
- Connect Secure API documentation (refer to your organization's API docs for detailed usage)
- n8n documentation on creating and using custom nodes with OpenAPI integration
- General REST API best practices for filtering, pagination, and sorting