Overview
This node integrates with the YouTrack API to retrieve detailed information about a specific issue. It is designed to fetch an issue by its unique identifier, allowing users to access various fields and metadata associated with that issue. This functionality is useful in scenarios such as automating issue tracking workflows, synchronizing issue data with other tools, or generating reports based on issue details.
For example, a user might use this node to:
- Automatically fetch the latest status and description of a bug report when triggered.
- Retrieve custom fields and links related to an issue for further processing or notifications.
- Integrate issue data into dashboards or project management systems.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate with the YouTrack API. Options: "Access Token" (using a personal access token) or "OAuth2" (using OAuth2 authentication flow). |
| Issue ID | The unique identifier of the issue to retrieve. This is required and must be provided as a string. |
| Receive Fields | A comma-separated list specifying which fields of the issue to return. By default, it includes type, creation date, custom fields, description, readable ID, links, project info, reporter, resolution status, summary, update info, and visibility details. |
Output
The node outputs JSON data representing the requested issue's details. The structure includes:
- Basic issue metadata such as
id,idReadable,summary,description,created,updated. - Custom fields with their IDs, names, and values.
- Links associated with the issue, including direction and link types.
- Project information including project name and short name.
- Reporter and updater details with login and ring ID.
- Visibility settings detailing permitted groups and users.
- Resolution status and other relevant issue attributes.
No binary data output is indicated for this operation.
Dependencies
- Requires connection to the YouTrack API endpoint.
- Requires either an API key credential (access token) or OAuth2 credentials configured in n8n.
- The base URL for the YouTrack instance must be set in the credentials configuration.
Troubleshooting
- Invalid Issue ID: If the provided issue ID does not exist or is malformed, the node will likely throw an error indicating the issue was not found. Verify the issue ID is correct.
- Authentication Errors: Using incorrect or expired credentials will result in authentication failures. Ensure the API token or OAuth2 credentials are valid and have sufficient permissions.
- Field Selection Issues: Requesting fields that do not exist or are not accessible may cause errors or incomplete data. Use the default field list or verify custom fields exist in your YouTrack instance.
- Network/Connection Problems: Ensure the YouTrack base URL is reachable from the n8n environment and no firewall or proxy blocks the requests.