YouTrack

List an issue’s change history, field changes, comments, links, and work items, with who changed what and when…

List agile boards, including the projects each covers and its current sprint. Returns board IDs needed by…

Get one agile board by ID (e.g. ‘204-0’). Use list_agiles to find board IDs.

List sprints on an agile board, with start and finish dates. Use list_agiles to find the board ID. To move an issue…

Get one sprint by board ID and sprint ID. Use list_sprints to find sprint IDs.

Create a sprint on an agile board. Requires the board ID (from list_agiles) and a name. Start and finish accept ISO…

Delete a sprint from an agile board. Issues on the sprint are not deleted, only unassigned from it. Use list_sprints…

List knowledge base articles, optionally filtered with a search query such as ‘project: DEMO onboarding’. Omits…

Get one article including its full Markdown content. Accepts an internal ID (‘186-0’) or readable ID (‘DEMO-A-1’)…

Create a knowledge base article in a project. Requires project_id (from list_projects) and summary. Pass…

Update an article’s title or Markdown content. Accepts an internal ID (‘186-0’) or readable ID (‘DEMO-A-1’). Use…

Permanently delete an article and all of its sub-articles. Use list_articles to find article IDs. This cannot be undone.

List comments on a knowledge base article. Accepts an internal ID (‘186-0’) or readable ID (‘DEMO-A-1’). For issue…

Add a comment to a knowledge base article. Accepts an internal ID (‘186-0’) or readable ID (‘DEMO-A-1’). For issue…

List files attached to an issue, including name, size, MIME type, and a download path relative to the instance URL…

Permanently delete a file attached to an issue. Use list_attachments to find attachment IDs. This cannot be undone.

List comments on an issue, oldest first. Accepts an internal issue ID (‘3-0’) or readable ID (‘DEMO-1’). Returns…

Add a comment to an issue. Accepts an internal issue ID (‘3-0’) or readable ID (‘DEMO-1’). Set silent=true to skip…

Edit a comment’s text or pin it. Use list_comments to find comment IDs. Only the comment’s author, or a user with…

Permanently delete a comment from an issue. Use list_comments to find comment IDs. This cannot be undone.

List every custom field available on issues in a project, with the exact ‘$type’ and allowed values each one needs…

List custom fields defined across the whole instance. Use discover_project_fields instead when building an issue…

Search issues using YouTrack query syntax, e.g. ‘project: DEMO State: Open assignee: me’ or ‘#Unresolved’. Sort by…

Get one issue with its description and custom field values. Accepts an internal ID (‘3-0’) or a readable ID…

Create an issue. Requires project_id (from list_projects) and summary. To set Priority, State, Assignee, or any…

Update an issue’s summary, description, or custom fields. Accepts an internal ID (‘3-0’) or readable ID (‘DEMO-1’)…

Permanently delete an issue and its comments, attachments, and work items. Accepts an internal ID (‘3-0’) or…

Count issues matching a YouTrack query without fetching them, e.g. ‘project: DEMO #Unresolved’. Cheaper than…

Apply a YouTrack command to one or more issues, e.g. ‘State Fixed’, ‘Priority Critical’, ‘for jane.doe’, ‘tag…

List an issue’s links, grouped by link type and direction. Returns the directed link IDs (e.g. ‘173-1s’ outward,…

List the link types configured on the instance, such as Relates, Depend, Duplicate, and Subtask, with their outward…

Link one issue to another. link_id is a directed link type ID such as ‘173-1s’ (outward) or ‘173-1t’ (inward), call…

Remove a link between two issues. link_id is the directed link type ID (e.g. ‘173-1s’), use list_issue_links to find…

List projects on the instance. Returns the internal project IDs (e.g. ‘0-0’) that create_issue, create_article, and…

Get one project by its internal ID (e.g. ‘0-0’). Use list_projects to find IDs.

Create a project. Requires name, short_name (the issue ID prefix, must be unique), and leader_id, use list_users or…

Update a project’s name, short name, description, owner, or archived state. Use list_projects to find the project…

Permanently delete a project and every issue and article in it. Use list_projects to find the project ID. This…

List the users on a project’s team, the people assignable to its issues. Use list_projects to find the project ID.

List saved searches visible to the current user. Each returns a query string that can be passed straight to…

Get valid completions for a partial issue search query, e.g. ‘stat’ suggests ‘State:’. Use this to build a correct…

Get valid completions for a partial YouTrack command against specific issues, e.g. ‘stat’ suggests the State values…

List issue tags visible to the current user. Returns the tag IDs that add_issue_tag and remove_issue_tag require. To…

Create an issue tag. Set untag_on_resolve=true to have YouTrack remove it automatically when an issue is resolved…

Permanently delete a tag and remove it from every issue carrying it. Use list_tags to find tag IDs. This cannot be…

Apply an existing tag to an issue. Use list_tags for tag IDs, or create_tag first. Accepts an internal issue ID…

Remove a tag from an issue. The tag itself is not deleted. Use list_tags or read the issue to find the tag ID.

Get the user the permanent token belongs to. Useful for resolving ‘me’ in queries and for supplying leader_id to…

List user accounts, optionally filtering server-side with query (matches login, full name, or email). Returns the…

Get one user by internal ID (e.g. ‘2-1’). Use list_users to find user IDs, or get_current_user for the authenticated…

List user groups on the instance. Group names are used when restricting comment visibility or setting group-typed…

List time-tracking entries across issues, for timesheet and reporting use. Filter server-side by query (e.g…

List the time logged against one issue. Accepts an internal ID (‘3-0’) or readable ID (‘DEMO-1’). Returns work item…

Log time against an issue. Requires the issue ID and minutes. Pass type_id from list_work_item_types to categorize…

Permanently delete a time-tracking entry from an issue. Use list_issue_work_items to find work item IDs. This cannot…

List the work item types configured on the instance, such as Development or Testing. Call this before…