v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB

orgs

Update issue field for an organization

Updates an 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.

patch/orgs/{org}/issue-fields/{issue_field_id}

Path parameters

orgstring required

The organization name. The name is not case sensitive.

issue_field_idinteger required

The unique identifier of the issue field.

Request body

namestring

Name of the issue field.

descriptionstring nullable

Description 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.

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.