Ivanti icon

Ivanti

Interact with Ivanti API
Join our community

Actions42

Overview

This node allows you to link an existing Incident record in Ivanti with another business object by establishing a specified relationship. It is useful when you need to programmatically associate incidents with related records (such as tasks, changes, or custom objects) within the Ivanti platform. For example, you might use this operation to link an incident to a related problem record or to a specific employee.

Common scenarios:

  • Associating an incident with a related task or change for better traceability.
  • Linking incidents to custom business objects for advanced workflows.
  • Automating relationships between records during integration or data migration processes.

Properties

Name Meaning
Record ID (Incident) The unique RecId value of the incident in Ivanti that you want to link.
Relationship Name The name of the relationship to be used for linking the business objects.
Record ID (Related Object) The unique RecId value of the related business object in Ivanti to be linked to the incident.

Output

The output will contain the result of the linking operation. Typically, this includes a JSON object reflecting the response from the Ivanti API after attempting to create the relationship. The structure may include status information or details about the created link.

{
  "status": "success",
  "details": {
    // Information about the link or any returned metadata
  }
}

Note: The exact fields depend on the Ivanti API's response.

Dependencies

  • External Service: Requires access to the Ivanti API.
  • Credentials: You must configure n8n with valid IvantiApi credentials, including the baseUrl for your Ivanti instance.
  • n8n Configuration: Ensure the Ivanti credential is set up and assigned to this node.

Troubleshooting

Common Issues:

  • Invalid Record IDs: If either the Incident or Related Object RecId is incorrect, the API will likely return a "Not Found" or similar error.
  • Incorrect Relationship Name: Using a non-existent or misspelled relationship name will cause the link operation to fail.
  • Authentication Errors: Missing or invalid credentials will prevent the node from connecting to the Ivanti API.

Error Messages and Resolutions:

  • "404 Not Found": Check that both Record IDs are correct and exist in Ivanti.
  • "401 Unauthorized": Verify that your IvantiApi credentials are correctly configured in n8n.
  • "400 Bad Request": Ensure all required properties are filled and the relationship name is valid.

Links and References

Discussion