Overview
This node integrates with the YouTrack issue tracking system, specifically allowing users to update existing issues. It is useful in scenarios where you want to programmatically modify issue details such as title, description, assignee, or project association within a workflow automation. For example, after receiving new information from another system, you can update an issue’s summary and description to keep your project management data current.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with YouTrack API: either using an Access Token or OAuth2 authentication flow. |
| Issue ID | The unique identifier of the issue to update. This is required to specify which issue will be modified. |
| Receive Fields | A string specifying which fields to receive back from the API after the update. Defaults to common issue fields like type, created date, custom fields, description, reporter, etc. |
| Project | The project to which the issue belongs. Can be specified by entering a project ID directly or selecting from a searchable list of projects. Required for updating the issue's project association. |
| Title | The updated title (summary) of the issue. This is a required field when updating an issue. |
| Description | The updated detailed description of the issue. Also required when updating. |
| Assignee | The user assigned to the issue. Optional field to change or set the assignee. |
Output
The node outputs JSON data representing the updated issue object as returned by the YouTrack API. This includes all requested fields specified in the "Receive Fields" property, such as issue metadata, custom fields, links, project info, reporter, status, and visibility settings. The output does not include binary data.
Dependencies
- Requires valid YouTrack API credentials, either an access token or OAuth2 credentials.
- The base URL for the YouTrack instance must be configured in the credentials.
- No additional external dependencies beyond the YouTrack API and n8n credential setup.
Troubleshooting
Common Issues:
- Invalid or missing Issue ID will cause the update to fail.
- Incorrect or expired authentication credentials will result in authorization errors.
- Providing invalid project IDs or assignee usernames may cause API errors.
- Network connectivity issues to the YouTrack server can prevent successful updates.
Error Messages:
- Authorization errors typically indicate problems with the API key or OAuth token; verify and refresh credentials.
- Validation errors from the API may indicate missing required fields like title or description.
- If the node throws an error about the project or issue not found, confirm that the IDs are correct and accessible by the authenticated user.