Create custom field context

Creates a custom field context.

If projectIds is empty, a global context is created. A global context is one that applies to all project. If issueTypeIds is empty, the context applies to all issue types.

Permissions required: Administer Jira global permission.

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/field//context' \ --header 'Content-Type: application/json' \ --data-raw '{ "description": "A context used to define the custom field options for bugs.", "issueTypeIds": [ "10010" ], "name": "Bug fields context", "projectIds": [] }'

Request

Path Params

fieldId

string

required

The ID of the custom field.

Body Params application/json

The details of a created custom field context.

description

string

optional

The description of the context.

issueTypeIds

array[string]

optional

The list of issue types IDs for the context. If the list is empty, the context refers to all issue types.

name

string

required

The name of the context.

projectIds

array[string]

optional

The list of project IDs associated with the context. If the list is empty, the context is global.

Examples

Responses

🟢201Returned if the custom field context is created.

application/json

Body

The details of a created custom field context.

description

string

optional

The description of the context.

string

read-onlyoptional

The ID of the context.

issueTypeIds

array[string]

optional

The list of issue types IDs for the context. If the list is empty, the context refers to all issue types.

name

string

required

The name of the context.

projectIds

array[string]

optional

The list of project IDs associated with the context. If the list is empty, the context is global.

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠404Returned if the field, project, or issue type is not found.

🟠409Returned if the issue type is a sub-task, but sub-tasks are disabled in Jira settings.