Sample - GitHub REST API
POST/orgs/{org}/issue-types

Create issue type for an organization

Create a new issue type for an organization.

You can find out more about issue types in Managing issue types in an organization.

To use this endpoint, the authenticated user must be an administrator for the organization. OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 4 body fields
orgstringrequired
The organization name. The name is not case sensitive.
namestringrequired
Name of the issue type.
is_enabledbooleanrequired
Whether or not the issue type is enabled at the organization level.
descriptionstringoptional
Description of the issue type.
colorstringoptional
Color for the issue type.
Allowed:graybluegreenyelloworangeredpinkpurple

3 status codes
200Response
idintegerrequired
The unique identifier of the issue type.
node_idstringrequired
The node identifier of the issue type.
namestringrequired
The name of the issue type.
descriptionstringrequired
The description of the issue type.
colorstringoptional
The color of the issue type.
Allowed:graybluegreenyelloworangeredpinkpurple
created_atstringoptional
The time the issue type created.
updated_atstringoptional
The time the issue type last updated.
is_enabledbooleanoptional
The enabled state of the issue type.
404Resource not found
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
422Validation failed, or the endpoint has been spammed.
messagestringrequired
documentation_urlstringrequired
errorsarray<string>optional

Error handling

A 404 is returned: Resource not found. A 422 is returned: Validation failed, or the endpoint has been spammed.