AvantGuard - ConnectSecure icon

AvantGuard - ConnectSecure

AvantGuard - ConnectSecure

Actions223

Overview

This node allows creating a new Asset by sending a POST request to an external API. It is useful in scenarios where you need to programmatically add asset records into a system, such as inventory management, IT asset tracking, or security monitoring platforms. For example, you can automate the creation of assets discovered during network scans or integrate asset data from other systems.

Properties

Name Meaning
X USER ID The user identifier required for authentication or tracking purposes. This value is sent as a header.
Additional Body Fields Optional JSON fields to include additional asset details in the request body. These include:
- data: A JSON object with default keys like os_patches, snmp_info, is_firewall, unique_id, etc.

The Additional Body Fields property lets you customize the asset data sent in the request body beyond the minimal required fields.

Output

The node outputs the response from the API call in the json field of the output item. This typically contains the created asset's details as returned by the server, including any identifiers or status information.

If the API supports binary data responses (not indicated here), it would be included accordingly, but this node primarily deals with JSON data.

Dependencies

  • Requires an API key credential for authenticating requests to the external service.
  • The base URL and authentication credentials must be configured in the node’s credentials settings.
  • The node uses HTTP headers, including a mandatory user ID header (X-USER-ID).

Troubleshooting

  • Missing or invalid X USER ID header: The API may reject requests without a valid user ID header. Ensure this property is set correctly.
  • Malformed JSON in Additional Body Fields: If the JSON provided in the data field is invalid, the request will fail. Validate JSON syntax before running.
  • API connectivity issues: Check network access and correct base URL configuration.
  • Authentication errors: Verify that the API key credential is valid and has necessary permissions.

Links and References

  • Refer to the external API documentation for detailed schema of the asset object and required fields.
  • JSON validation tools can help ensure the correctness of the data JSON input.

Discussion