AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node operation retrieves log entries associated with a specific ticket by its Ticket Id from a ticketing system. It is useful for tracking the history and changes made to a ticket, such as comments, status updates, or other logged events. Practical applications include auditing ticket activity, monitoring progress, or extracting detailed ticket histories for reporting or integration purposes.

Properties

Name Meaning
Ticket Id The unique identifier of the ticket for which log entries are to be retrieved.
Additional Query Parameters Optional filters and pagination controls for refining the log entries returned:
- Type Filter log entries by type. Options: DESCRIPTION, COMMENT, CONDITION, SAVE, DELETE
- Create Time Filter log entries by their creation time (string format expected).
- Anchor Id Numeric filter parameter, possibly to anchor or offset the query results.
- Page Size Number of log entries to return per page; default is 500.

Output

The output consists of JSON data representing the list of log entries for the specified ticket. Each entry typically includes details such as the type of log entry (e.g., comment or description), timestamps, and content related to the ticket's history. If binary data were involved, it would represent attachments or files linked to the log entries, but this operation focuses on JSON-formatted log information.

Dependencies

  • Requires an API key credential for authenticating requests to the ticketing system.
  • Needs the base URL of the ticketing API configured in the node credentials.
  • Depends on the external ticketing service's API endpoint that supports querying ticket log entries by ticket ID.

Troubleshooting

  • Common Issues:
    • Invalid or missing Ticket Id will result in no data or errors.
    • Incorrect API credentials or base URL configuration can cause authentication failures.
    • Using unsupported or incorrectly formatted additional query parameters may lead to unexpected results or API errors.
  • Error Messages:
    • Authentication errors indicate issues with the API key or credential setup.
    • "Ticket not found" or empty responses suggest the Ticket Id does not exist or has no log entries.
    • Pagination limits exceeded if the page size is set too high; reduce the number accordingly.

Links and References

  • Refer to the ticketing system’s official API documentation for detailed descriptions of log entry types and query parameters.
  • n8n documentation on how to configure API credentials and use collection-type input properties.

Discussion