v5

latestOpenAPI 3.0.1Apache 2.02026-08-046169702.3 MB
Issue custom field contexts

Add issue types to context

Adds issue types to a custom field context, appending the issue types to the issue types list.

A custom field context without any issue types applies to all issue types. Adding issue types to such a custom field context would result in it applying to only the listed issue types.

If any of the issue types exists in the custom field context, the operation fails and no issue types are added.

This API will not allow adding issue types to the global context from April 2026. Instead, an HTTP 400 response will be returned. See CHANGE-3019

Permissions required: Administer Jira global permission.

put/rest/api/3/field/{fieldId}/context/{contextId}/issuetype

Path parameters

fieldIdstring required

The ID of the custom field.

contextIdinteger required

The ID of the context.

Request body

issueTypeIdsstring[] required

The list of issue type IDs.

Response

Returned if operation is successful.

{"stackTrail":"paths:/rest/api/3/field/{fieldId}/context/{contextId}/issuetype:put:responses:204:content:application/json:schema","oasType":"schema","type":"unknown"}