v68

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,21696712.3 MB

orgs

Create issue field for an organization

Creates a new issue field for an organization.

You can find out more about issue fields in Managing issue fields 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.

post/orgs/{org}/issue-fields

Path parameters

orgstring required

The organization name. The name is not case sensitive.

Request body

namestring required

Name of the issue field.

descriptionstring nullable

Description of the issue field.

data_type'text' | 'date' | 'single_select' | 'multi_select' | 'number' required

The data type of the issue field.

visibility'organization_members_only' | 'all'

The visibility of the issue field. Can be organization_members_only (visible only within the organization) or all (visible to all users who can see issues). Only used when the visibility settings feature is enabled. Defaults to organization_members_only.

Response

idinteger required

The unique identifier of the issue field.

node_idstring required

The node identifier of the issue field.

namestring required

The name of the issue field.

descriptionstring nullable

The description of the issue field.

data_type'text' | 'date' | 'single_select' | 'multi_select' | 'number' required

The data type of the issue field.

visibility'organization_members_only' | 'all'

The visibility of the issue field. Can be organization_members_only (visible only within the organization) or all (visible to all users who can see issues).

created_atstring date-time

The time the issue field was created.

updated_atstring date-time

The time the issue field was last updated.