canonical: https://jentic.com/apis/jetbrains.com/youtrack # Jetbrains YouTrack REST API The YouTrack REST API tracks issues, agile boards, and knowledge-base articles for software teams on JetBrains YouTrack. Issues are created, read, updated, and searched, and a command operation applies YouTrack commands to change issue state in bulk. Agile boards, saved queries, tags, work items, and users round out the project surface, and a large admin area manages the projects, groups, roles, and permissions behind them. ## For AI agents Create, read, update, and search YouTrack issues, apply commands to them, and manage agile boards, articles, tags, saved queries, and users through the JetBrains YouTrack REST API. ## Scope Does not host source code, run CI pipelines, or handle billing. Use for tracking YouTrack issues, agile boards, and articles only. ## Capabilities - Create, read, and update issues - Search issues and count matches with a saved or ad hoc query - Apply YouTrack commands to change issue state in bulk - Manage agile boards and their sprints - Create and update knowledge-base articles - Manage tags, saved queries, and users across projects ## Use cases ### Agent-Driven Issue Triage An AI agent connected through Jentic triages incoming reports by searching issues for duplicates, creating a new issue when none matches, and applying a command to set its priority and assignee. Because the command operation changes issue state in one call, the agent files and routes a ticket without clicking through the YouTrack UI. Example prompt: Search issues for a duplicate, create a new issue if none exists, then apply a command to set its priority and assignee ### Agile Board Automation Scrum teams keep a board current from automation. YouTrack exposes agile boards and the issues on them, so an agent lists the boards, reads the issues in a sprint, and updates their state as work progresses. Example prompt: List the agile boards, read the issues in the active sprint, and move completed issues to the next state ### Knowledge Base Updates Teams documenting a project maintain articles alongside issues. The YouTrack articles operations create and update knowledge-base articles, so an agent publishes release notes or runbooks from a workflow and links them to the issues they describe. Example prompt: Create a knowledge-base article from release notes and update it when the related issues change ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/issues` | List and search issues | | POST | `/issues` | Create an issue | | GET | `/issues/{id}` | Get an issue by id | | POST | `/commands` | Apply a command to issues | | GET | `/agiles` | List agile boards | | POST | `/articles` | Create a knowledge-base article | | GET | `/savedQueries` | List saved queries | ## Key resources - **Issues** — Create, read, update, and search issues - **Commands** — Apply YouTrack commands to change issue state in bulk - **Agiles** — Manage agile boards and their sprints - **Articles** — Create and update knowledge-base articles - **Saved queries and tags** — Manage saved searches and tags across projects - **Admin** — Manage projects, groups, roles, and permissions ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 11 / 100 - **Maturity:** Non-Ready - **Dimensions:** - Foundational Compliance: 36 / 100 - Developer Experience & Jentic Compatibility: 58 / 100 - AI-Readiness & Agent Experience: 5 / 100 - Agent Usability: 41 / 100 - Security: 60 / 100 - AI Discoverability: 4 / 100 - **View full report:** https://jentic.com/apis/jetbrains.com/youtrack/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring YouTrack by hand means issuing a permanent token, setting the `Authorization` bearer header, and learning the YouTrack query and command syntax before you can file an issue. Through Jentic you install once, import the YouTrack REST API from the API Directory, store the token once, and your agent calls the issue and board operations. - **Permission scoping:** YouTrack carries read operations for issues, boards, and articles alongside write operations and a large admin surface for projects, groups, roles, and permissions. You choose the operations your agent may call, so a rule can keep it to reading and creating issues and leave admin operations out unless you add them. - **Credential handling:** Your YouTrack permanent token is held by your own Jentic One instance, encrypted, and injected into the `Authorization` header at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'create a YouTrack issue' or 'list agile boards', and Jentic returns the matching YouTrack operation with its input schema so the agent calls the right endpoint among the 272 without browsing the reference docs. ## Related APIs - **Jira Cloud REST API** — Jira is Atlassian's issue tracker and agile tool, an alternative to YouTrack for the same project workflows. - **Linear API** — Linear is a streamlined issue tracker for software teams, an alternative to YouTrack's richer admin surface. - **GitLab REST API** — GitLab manages source control and merge requests that pair with YouTrack issues on the same work. ## FAQ ### What authentication does the YouTrack REST API use? The API uses bearer authentication with a YouTrack permanent token sent in the `Authorization` header, per its OpenAPI spec. Through Jentic the token is held by your own Jentic One instance and attached to each request at execution time, so it never appears in your agent's prompt or logs. ### Can I create and search issues with the YouTrack REST API? Yes. You create an issue, read it by id, and search issues with a query, and the command operation applies a YouTrack command to change state such as priority or assignee. Your agent files and routes tickets without stepping through the UI. ### What are the rate limits for the YouTrack REST API? The OpenAPI spec does not specify rate limits, which depend on your YouTrack instance configuration. Check the YouTrack REST API documentation at https://www.jetbrains.com/help/youtrack/devportal/youtrack-rest-api.html for current guidance before running bulk issue jobs. ### Is there a YouTrack MCP server? You do not need an MCP server to give your agent the YouTrack REST API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent calls the issue, board, and article operations on demand without loading an extra server's tool definitions into its context. ### Can I limit what my agent is allowed to do with the YouTrack REST API? Yes. The spec spans issues, boards, articles, and a large admin surface, so write a rule that allows only the issue read and create operations. The agent can then list and file issues and cannot run bulk commands or reach the admin area unless you add those operations. You choose what it may call, and every call it makes is logged. ### How do I create an issue through Jentic? Install the Jentic One command line with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then add the YouTrack REST API from the Jentic directory and search by intent such as 'create a YouTrack issue'. Jentic returns the matching operation with its input schema so your agent builds a valid request. To run it on your own infrastructure, install Jentic One from its GitHub repo.