---
schema: rendered-html/v1
title: "YouTrack REST API | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/youtrack-rest-api.html
generated_at: 2026-06-11T15:21:20.479563+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- [YouTrack REST API](youtrack-rest-api.html)
- Get Started with REST API
- REST API Reference
- REST API Use Cases
- REST API Troubleshooting
- Color Indices List
- Hub REST API

# YouTrack REST API﻿

Last modified: 11 May 2026

YouTrack REST API lets you perform programmatically various actions in the tracker:

- Import issues from your current bug tracking system — for smoother migration to YouTrack.
- Create, modify, and perform other operations with issues — so you can seamlessly integrate YouTrack into your environment. For example, via automated issue submission from third-party applications.
- Manipulate projects, custom fields and sets of values, agile boards, issue link types, and other parameters.

> ### note
>
> User, Group, Project Team, Organization, and Role Management in YouTrack REST API Starting from 2026.1
>
> Starting from version 2026.1, the YouTrack REST API includes user, group, project team, organization, and role–related endpoints, entities, properties, and resources that were previously available only in the Hub REST API. See the YouTrack REST API reference to explore the full set of available operations and updates. For Hub endpoints that no longer return or update YouTrack data, see Hub REST API Endpoints Deprecated in YouTrack 2026.1.

## General Notes﻿

The REST API returns and consumes data in JSON format. Regular [content negotiation](https://en.wikipedia.org/wiki/Content_negotiation) rules apply:

- You must provide the Authorization HTTP request header for each request. The recommended authorization method is using a permanent token. To learn how to obtain a permanent token, see Manage Permanent Tokens.

  For details about supported authorization methods, see Log in to YouTrack.
- Use the Accept HTTP request header to indicate the expected response data format: `application/json`.
- Use the Content-Type HTTP request header for POST and PUT requests: `application/json`.

The REST API is always enabled. However, a system administrator can specify which sites (origins) are allowed to access YouTrack using REST. For more information, see Managing Global Settings.

## Tools and Client Libraries Based on the YouTrack REST API﻿

Before you start using the REST API for your own development, take a look at a few tools that use the YouTrack REST API:

- [YouTrackSharp](https://github.com/JetBrains/YouTrackSharp) is a .NET library for accessing the YouTrack REST API. This library is also available from the [NuGet gallery](https://nuget.org/List/Packages/YouTrackSharp).

  > ### warning
  >
  > YouTrackSharp covers a subset of the API offered by YouTrack. Should it prove insufficient for your needs, consider using YouTrack REST API directly.
- [YouTrack Mobile](https://github.com/JetBrains/youtrack-mobile) uses the REST API to pull data from a YouTrack installation and display it in a mobile app.
- [YouTrack Integration Plugin](https://github.com/jk1/youtrack-idea-plugin) for IntelliJ IDEA and other JetBrains IDEs uses the REST API to display issue-related information directly in an IDE.

- [YouTrack REST API](/help/youtrack/devportal/youtrack-rest-api.html)
- [General Notes](/help/youtrack/devportal/youtrack-rest-api.html#general-notes)
- [Tools and Client Libraries Based on the YouTrack REST API](/help/youtrack/devportal/youtrack-rest-api.html#youtrack-api-based-tools)

Form API ReferenceGet Started with REST API

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.
