{"meta":{"title":"Конечные точки REST API для типов проблем","intro":"Используйте REST API для взаимодействия с типами проблем в организации.","product":"REST API","breadcrumbs":[{"href":"/ru/rest","title":"REST API"},{"href":"/ru/rest/orgs","title":"Организации"},{"href":"/ru/rest/orgs/issue-types","title":"Типы проблем"}],"documentType":"article"},"body":"# Конечные точки REST API для типов проблем\n\nИспользуйте REST API для взаимодействия с типами проблем в организации.\n\n> [!NOTE]\n> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.\n\n## List issue types for an organization\n\n```\nGET /orgs/{org}/issue-types\n```\n\nLists all issue types for an organization. OAuth app tokens and personal access tokens (classic) need the read:org scope to use this endpoint.\n\n### Parameters\n\n#### Headers\n\n- **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n- **`org`** (string) (required)\n  The organization name. The name is not case sensitive.\n\n### HTTP response status codes\n\n- **200** - OK\n\n- **404** - Resource not found\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/orgs/ORG/issue-types\n```\n\n**Response schema (Status: 200):**\n\nArray of `Issue Type`:\n  * `id`: required, integer\n  * `node_id`: required, string\n  * `name`: required, string\n  * `description`: required, string or null\n  * `color`: string or null, enum: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `null`\n  * `created_at`: string, format: date-time\n  * `updated_at`: string, format: date-time\n  * `is_enabled`: boolean\n\n## Create issue type for an organization\n\n```\nPOST /orgs/{org}/issue-types\n```\n\nCreate a new issue type for an organization.\nYou can find out more about issue types in Managing issue types in an organization.\nTo use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and\npersonal access tokens (classic) need the admin:org scope to use this endpoint.\n\n### Parameters\n\n#### Headers\n\n- **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n- **`org`** (string) (required)\n  The organization name. The name is not case sensitive.\n\n#### Body parameters\n\n- **`name`** (string) (required)\n  Name of the issue type.\n\n- **`is_enabled`** (boolean) (required)\n  Whether or not the issue type is enabled at the organization level.\n\n- **`description`** (string or null)\n  Description of the issue type.\n\n- **`color`** (string or null)\n  Color for the issue type.\n  Can be one of: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `null`\n\n### HTTP response status codes\n\n- **200** - OK\n\n- **404** - Resource not found\n\n- **422** - Validation failed, or the endpoint has been spammed.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X POST \\\n  https://api.github.com/orgs/ORG/issue-types \\\n  -d '{\n  \"name\": \"Epic\",\n  \"description\": \"An issue type for a multi-week tracking of work\",\n  \"is_enabled\": true,\n  \"color\": \"green\"\n}'\n```\n\n**Response schema (Status: 200):**\n\n* `id`: required, integer\n* `node_id`: required, string\n* `name`: required, string\n* `description`: required, string or null\n* `color`: string or null, enum: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `null`\n* `created_at`: string, format: date-time\n* `updated_at`: string, format: date-time\n* `is_enabled`: boolean\n\n## Update issue type for an organization\n\n```\nPUT /orgs/{org}/issue-types/{issue_type_id}\n```\n\nUpdates an issue type for an organization.\nYou can find out more about issue types in Managing issue types in an organization.\nTo use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and\npersonal access tokens (classic) need the admin:org scope to use this endpoint.\n\n### Parameters\n\n#### Headers\n\n- **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n- **`org`** (string) (required)\n  The organization name. The name is not case sensitive.\n\n- **`issue_type_id`** (integer) (required)\n  The unique identifier of the issue type.\n\n#### Body parameters\n\n- **`name`** (string) (required)\n  Name of the issue type.\n\n- **`is_enabled`** (boolean) (required)\n  Whether or not the issue type is enabled at the organization level.\n\n- **`description`** (string or null)\n  Description of the issue type.\n\n- **`color`** (string or null)\n  Color for the issue type.\n  Can be one of: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `null`\n\n### HTTP response status codes\n\n- **200** - OK\n\n- **404** - Resource not found\n\n- **422** - Validation failed, or the endpoint has been spammed.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X PUT \\\n  https://api.github.com/orgs/ORG/issue-types/ISSUE_TYPE_ID \\\n  -d '{\n  \"name\": \"Epic\",\n  \"description\": \"An issue type for a multi-week tracking of work\",\n  \"is_enabled\": true,\n  \"color\": \"green\"\n}'\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [Create issue type for an organization](#create-issue-type-for-an-organization).\n\n## Delete issue type for an organization\n\n```\nDELETE /orgs/{org}/issue-types/{issue_type_id}\n```\n\nDeletes an issue type for an organization.\nYou can find out more about issue types in Managing issue types in an organization.\nTo use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and\npersonal access tokens (classic) need the admin:org scope to use this endpoint.\n\n### Parameters\n\n#### Headers\n\n- **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n- **`org`** (string) (required)\n  The organization name. The name is not case sensitive.\n\n- **`issue_type_id`** (integer) (required)\n  The unique identifier of the issue type.\n\n### HTTP response status codes\n\n- **204** - No Content\n\n- **404** - Resource not found\n\n- **422** - Validation failed, or the endpoint has been spammed.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X DELETE \\\n  https://api.github.com/orgs/ORG/issue-types/ISSUE_TYPE_ID\n```\n\n**Response schema (Status: 204):**"}