REST API endpoints for issue types

List issue types

Lists all issue types for the authenticated user. OAuth app tokens and personal access tokens (classic) need the read:user scope to use this endpoint.

Детализированные токены доступа для «List issue types»

Эта конечная точка работает со следующими точными типами маркеров:

Маркер с точной детализацией должен иметь следующий набор разрешений.:

"Issue Types" user permissions (read)

HTTP-коды статуса ответа для «List issue types»

Код состояния	Description
`200`	OK
`404`	Resource not found

Примеры кода для «List issue types»

Если вы получаете доступ к GitHub на GHE.com, замените api.github.com на выделенный поддомен вашего предприятия в api.SUBDOMAIN.ghe.com.

Пример запроса

get/user/issue-types

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/user/issue-types

Response

Status: 200

[
  {
    "id": 410,
    "node_id": "IT_kwDNAd3NAZo",
    "name": "Task",
    "description": "A specific piece of work",
    "created_at": "2024-12-11T14:39:09Z",
    "updated_at": "2024-12-11T14:39:09Z"
  },
  {
    "id": 411,
    "node_id": "IT_kwDNAd3NAZs",
    "name": "Bug",
    "description": "An unexpected problem or behavior",
    "created_at": "2024-12-11T14:39:09Z",
    "updated_at": "2024-12-11T14:39:09Z"
  }
]

Create an issue type

Creates a new issue type for the authenticated user's personal account.

OAuth app tokens and personal access tokens (classic) need the user scope to use this endpoint.

Детализированные токены доступа для «Create an issue type»

Эта конечная точка работает со следующими точными типами маркеров:

Маркер с точной детализацией должен иметь следующий набор разрешений.:

"Issue Types" user permissions (write)

Параметры для «Create an issue type»

Заголовки
Имя., Тип, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Параметры запроса
Имя., Тип, Description
`name` string Обязательное поле Name of the issue type.
`is_enabled` boolean Обязательное поле Whether or not the issue type is enabled.
`description` string or null Description of the issue type.
`color` string or null Color for the issue type. Возможные значения: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `null`

HTTP-коды статуса ответа для «Create an issue type»

Код состояния	Description
`200`	OK
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.

Примеры кода для «Create an issue type»

Если вы получаете доступ к GitHub на GHE.com, замените api.github.com на выделенный поддомен вашего предприятия в api.SUBDOMAIN.ghe.com.

Пример запроса

post/user/issue-types

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/user/issue-types \
  -d '{"name":"Epic","description":"An issue type for a multi-week tracking of work","is_enabled":true,"color":"green"}'

Response

Status: 200

{
  "id": 410,
  "node_id": "IT_kwDNAd3NAZo",
  "name": "Task",
  "description": "A specific piece of work",
  "created_at": "2024-12-11T14:39:09Z",
  "updated_at": "2024-12-11T14:39:09Z"
}

Update an issue type

Updates an issue type for the authenticated user.

The authenticated user must own the issue type. OAuth app tokens and personal access tokens (classic) need the user scope to use this endpoint.

Детализированные токены доступа для «Update an issue type»

Эта конечная точка работает со следующими точными типами маркеров:

Маркер с точной детализацией должен иметь следующий набор разрешений.:

"Issue Types" user permissions (write)

Параметры для «Update an issue type»

Заголовки
Имя., Тип, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Параметры пути
Имя., Тип, Description
`issue_type_id` integer Обязательное поле The unique identifier of the issue type.

Параметры запроса
Имя., Тип, Description
`name` string Обязательное поле Name of the issue type.
`is_enabled` boolean Обязательное поле Whether or not the issue type is enabled.
`description` string or null Description of the issue type.
`color` string or null Color for the issue type. Возможные значения: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `null`

HTTP-коды статуса ответа для «Update an issue type»

Код состояния	Description
`200`	OK
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.

Примеры кода для «Update an issue type»

Если вы получаете доступ к GitHub на GHE.com, замените api.github.com на выделенный поддомен вашего предприятия в api.SUBDOMAIN.ghe.com.

Пример запроса

put/user/issue-types/{issue_type_id}

curl -L \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/user/issue-types/ISSUE_TYPE_ID \
  -d '{"name":"Epic","description":"An issue type for a multi-week tracking of work","is_enabled":true,"color":"green"}'

Response

Status: 200

{
  "id": 410,
  "node_id": "IT_kwDNAd3NAZo",
  "name": "Task",
  "description": "A specific piece of work",
  "created_at": "2024-12-11T14:39:09Z",
  "updated_at": "2024-12-11T14:39:09Z"
}

Delete an issue type

Deletes an issue type for the authenticated user.

The authenticated user must own the issue type. OAuth app tokens and personal access tokens (classic) need the user scope to use this endpoint.

Детализированные токены доступа для «Delete an issue type»

Эта конечная точка работает со следующими точными типами маркеров:

Маркер с точной детализацией должен иметь следующий набор разрешений.:

"Issue Types" user permissions (write)

Параметры для «Delete an issue type»

Заголовки
Имя., Тип, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Параметры пути
Имя., Тип, Description
`issue_type_id` integer Обязательное поле The unique identifier of the issue type.

HTTP-коды статуса ответа для «Delete an issue type»

Код состояния	Description
`204`	No Content
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.

Примеры кода для «Delete an issue type»

Если вы получаете доступ к GitHub на GHE.com, замените api.github.com на выделенный поддомен вашего предприятия в api.SUBDOMAIN.ghe.com.

Пример запроса

delete/user/issue-types/{issue_type_id}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/user/issue-types/ISSUE_TYPE_ID

Response

Status: 204

List issue types

Детализированные токены доступа для «List issue types»

HTTP-коды статуса ответа для «List issue types»

Примеры кода для «List issue types»

Пример запроса

Response

Create an issue type

Детализированные токены доступа для «Create an issue type»

Параметры для «Create an issue type»

HTTP-коды статуса ответа для «Create an issue type»

Примеры кода для «Create an issue type»

Пример запроса

Response

Update an issue type

Детализированные токены доступа для «Update an issue type»

Параметры для «Update an issue type»

HTTP-коды статуса ответа для «Update an issue type»

Примеры кода для «Update an issue type»

Пример запроса

Response

Delete an issue type

Детализированные токены доступа для «Delete an issue type»

Параметры для «Delete an issue type»

HTTP-коды статуса ответа для «Delete an issue type»

Примеры кода для «Delete an issue type»

Пример запроса

Response

Была ли эта документация полезной?

По-прежнему нужна помощь?