Ivanti icon

Ivanti

Interact with Ivanti API
Join our community

Actions42

Overview

The Ivanti node for n8n allows you to interact with the Ivanti API, specifically targeting various business objects such as Tasks.
For the Task → Get operation, this node retrieves details about a specific task from Ivanti based on either its AssignmentID (Number) or RecId (Record ID).
This is useful in scenarios where you need to fetch task information for reporting, automation, or integration with other systems.

Example use cases:

  • Retrieve task details by Record ID to update another system.
  • Fetch a task by AssignmentID to check its status before proceeding in a workflow.
  • Pull only selected fields of a task for lightweight data processing.

Properties

Name Meaning
ID Type Choose how to identify the task:
- Number (AssignmentID)
- Record ID (RecId)
Number AssignmentID value of the task in Ivanti. Required if "ID Type" is set to "Number".
Record ID RecId value of the task in Ivanti. Required if "ID Type" is set to "Record ID".
Query Parameters Additional query parameters to refine your request.
└ Select Fields Comma-separated list of fields to include in the response (e.g., AssignmentID, RecId, Status, Owner).

Output

The output will be a JSON object containing the details of the requested task.
The structure depends on the fields selected via "Select Fields" or defaults to all available fields for the task object.

Example output:

{
  "AssignmentID": "12345",
  "RecId": "abcde-12345",
  "Status": "Open",
  "Owner": "John Doe"
}

If binary data is returned (not typical for this operation), it would represent file attachments or similar content related to the task.

Dependencies

  • External Service: Requires access to an Ivanti instance with the OData API enabled.
  • API Credentials: Needs an n8n credential named IvantiApi with at least a baseUrl property configured.
  • n8n Configuration: No special environment variables required beyond standard credential setup.

Troubleshooting

Common issues:

  • Invalid credentials: If the IvantiApi credential is missing or incorrect, authentication errors will occur.
  • Incorrect ID Type/Value: Supplying the wrong type or value for the task identifier will result in no data or an error.
  • Field selection errors: Specifying non-existent fields in "Select Fields" may cause the API to return errors or empty results.

Error messages and resolutions:

  • "401 Unauthorized": Check your Ivanti API credentials in n8n.
  • "404 Not Found": Ensure the provided AssignmentID or RecId exists in Ivanti.
  • "400 Bad Request": Verify that the query parameters and field names are valid according to the Ivanti API documentation.

Links and References

Discussion