Managing Youtrack

Interact with YouTrack issue tracker via REST API. Create, read, update, and search issues and drafts; manage comments, tags, and issue links; log work items; inspect custom field schemas; list saved queries; look up users and groups. Use when the user asks about YouTrack issues, wants to file bugs, update tickets, add comments, manage tags or links, track time, or search for issues. Requires YOUTRACK_URL and YOUTRACK_TOKEN environment variables.

jetbrains c6ab2ac 5 files · 7.0 KB Updated

File contents

YouTrack REST API

Setup (minimal)

  • NEVER use pipes after curl commands to parse the output, do that in a separate tool call.
  • Always pass the auth header via "${YOUTRACK_TOKEN}". Always include Accept: application/json; add Content-Type: application/json for write calls.
  • For queries containing spaces or symbols, use curl -G --data-urlencode "query=..." instead of embedding the query string.
  • Request only needed fields via the fields parameter; default minimal issue fields: idReadable,summary.

Navigation

  • Issues, drafts, comments → reference/issues.md
  • Tags, links, work items → reference/metadata.md
  • Fields, saved searches, users, groups → reference/admin.md
  • Field presets and $type values → reference/fields.md

Output requirement

After create/update/delete, print a link to the affected item:

  • Issue: $YOUTRACK_URL/issue/<idReadable>
  • Comment: $YOUTRACK_URL/issue/<idReadable>#focus=Comments-<COMMENT_ID>
  • Drafts have no web URL.

jetbrains/skills/tree/main/managing-youtrack commit c6ab2ac4f2

Frequently asked questions

npx skillmds@latest add jetbrains/managing-youtrack