Request Headers

This page covers main HTTP request headers that are used in YouTrack REST API. HTTP headers basically describe the API request and the data it contains or expects to be returned.

Header	Description
`Authorization`	Mandatory You must provide the `Authorization` header for each request. For example: 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' For details about supported authorization methods, read Log in to YouTrack.
`Accept`	This header defines in which format you expect the response body to be returned by the server. Provide this header for `GET` methods, or if you request entity attributes in the `fields` request parameter for any other method, then also provide this header. YouTrack supports JSON format for returned data. That is, use `'Accept: application/json'`.
`Content-Type`	This header defines in which format you send request payload data to the server. Provide this header for `POST` and `PUT` methods. YouTrack supports JSON format for the request payload data. That is, use `'Content-Type: application/json'`. For attachments, YouTrack also supports other types for the `Content-Type` header. See examples on the Attach Files to an Issue page.

Header

Description

Authorization

Mandatory You must provide the Authorization header for each request. For example:

          'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7'
        

For details about supported authorization methods, read Log in to YouTrack.

Accept

This header defines in which format you expect the response body to be returned by the server. Provide this header for GET methods, or if you request entity attributes in the fields request parameter for any other method, then also provide this header. YouTrack supports JSON format for returned data. That is, use 'Accept: application/json'.

Content-Type

This header defines in which format you send request payload data to the server. Provide this header for POST and PUT methods. YouTrack supports JSON format for the request payload data. That is, use 'Content-Type: application/json'.

Last modified: 27 September 2023