Jira Data Center icon

Jira Data Center

Interact with Jira Data Center API

Actions16

Issue → Transition

AI-generated

Overview

This node integrates with the Jira Data Center API to perform various operations on Jira issues. Specifically, the "Transition" operation for the "Issue" resource allows users to change the status of a Jira issue by executing a workflow transition. This is useful in scenarios where you want to automate issue progressions, such as moving an issue from "To Do" to "In Progress" or "Done" based on external triggers or workflows.

Practical examples include:

  • Automatically transitioning an issue when a related task in another system is completed.
  • Moving issues through different stages in a CI/CD pipeline.
  • Updating issue statuses in bulk based on certain criteria.

Properties

Name Meaning
Authentication Method of authentication: "Personal Access Token" or "Basic Auth".
Issue Key The unique key of the Jira issue to transition (e.g., PROJ-123).
Transition ID The ID of the transition to execute, representing the target status in the workflow.

Output

The output JSON contains a single field indicating success:

{
  "success": true
}

This confirms that the transition was executed successfully. There is no binary data output for this operation.

Dependencies

  • Requires access to a Jira Data Center instance.
  • Needs either a Personal Access Token or Basic Authentication credentials configured in n8n.
  • The node uses the Jira REST API endpoint /rest/api/2/issue/{issueKey}/transitions to perform the transition.

Troubleshooting

  • Common Issues:

    • Invalid or missing Issue Key: Ensure the issue key exists and is correctly formatted.
    • Incorrect Transition ID: The transition ID must correspond to a valid transition available for the issue's current status.
    • Authentication failures: Verify that the provided credentials have sufficient permissions to transition issues.
    • Network or server errors: Check connectivity to the Jira Data Center server.

  • Error Messages:

    • "Jira Data Center API request failed: <error message>": Indicates an issue with the API call; check credentials, URL, and parameters.
    • "The operation "transition" is not supported for resource "issue": This would indicate a misconfiguration but should not occur if using the node properly.

To resolve errors, verify all input parameters, ensure correct authentication setup, and confirm that the transition ID is valid for the given issue.

Links and References

Discussion