AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node updates checklist templates in the target system. It allows users to modify existing checklist templates by sending updated data, such as descriptions and tasks, to the API endpoint managing these templates. This is useful for automating the maintenance of standardized checklists used in workflows, quality assurance, or task management.

Practical examples include:

  • Updating the description of a checklist template to reflect new procedures.
  • Modifying tasks within a checklist template to add, remove, or change steps.
  • Automating bulk updates to multiple checklist templates based on changing requirements.

Properties

Name Meaning
Additional Body Fields Optional JSON fields to include in the request body when updating a checklist template. This can contain properties like description and an array of tasks, each with their own description. The user provides this as a JSON object to customize the update payload.

Output

The node outputs JSON data representing the response from the API after updating the checklist template. This typically includes the updated checklist template details such as its ID, description, tasks, and any other metadata returned by the service.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authentication with the external service.
  • Needs the base URL of the API configured in the node credentials.
  • Depends on the external API defined in the bundled OpenAPI specification (openapi.json) for making requests.

Troubleshooting

  • Invalid JSON in Additional Body Fields: If the JSON provided in the "Additional Body Fields" property is malformed, the node will fail to parse it, causing errors. Ensure valid JSON syntax.
  • Authentication Errors: Missing or incorrect API credentials will result in authorization failures. Verify that the API key and base URL are correctly set in the node credentials.
  • API Endpoint Errors: If the checklist template ID does not exist or the API rejects the update due to validation errors, the node will return error messages from the API. Check the API response for details and adjust the input accordingly.
  • Empty or Missing Required Fields: The node expects certain fields in the update payload (like description or tasks). Omitting required fields may cause the API to reject the request.

Links and References

  • Refer to the external API documentation for checklist templates to understand the expected structure of the update payload.
  • JSON formatting guides to help construct valid JSON for the "Additional Body Fields".

Discussion