Skip to content
forgit api docs

List issue types for a repository

GET
/repos/{owner}/{repo}/issue-types

Lists issue types available for a repository (inherited from its organization owner, with any per-repository overrides applied). OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint. Fine-grained access tokens require the “Metadata” repository permission (read).

API method documentation

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
owner
required
string

The account owner of the repository. The name is not case sensitive.

repo
required
string

The name of the repository without the .git extension. The name is not case sensitive.

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Response

Media type application/json
Array<object>
Issue Type

The type assigned to the issue. This is only present for issues in repositories where issue types are supported.

object
id
required

The unique identifier of the issue type.

integer
node_id
required

The node identifier of the issue type.

string
name
required

The name of the issue type.

string
description
required

The description of the issue type.

string
nullable
color

The color of the issue type.

string
nullable
Allowed values: gray blue green yellow orange red pink purple
created_at

The time the issue type created.

string format: date-time
updated_at

The time the issue type last updated.

string format: date-time
is_enabled

The enabled state of the issue type.

boolean
Examples
Example default 
[
  {
    "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"
  }
]

404

Section titled “ 404 ”

Resource not found

Media type application/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Example generated 
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}