Create custom field options (context)

POST

/rest/api/3/field/{fieldId}/context/{contextId}/option

Creates options and, where the custom select field is of the type Select List (cascading), cascading options for a custom select field. The options are added to a context of the field.

The maximum number of options that can be created per request is 1000 and each field can have a maximum of 10000 options.

This operation works for custom field options created in Jira or the operations from this resource. To work with issue field select list options created for Connect apps use the Issue custom field options (apps) operations.

Permissions required: Administer Jira global permission.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/field//context//option' \
--header 'Content-Type: application/json' \
--data-raw '{
    "options": [
        {
            "disabled": false,
            "value": "Scranton"
        },
        {
            "disabled": true,
            "optionId": "10000",
            "value": "Manhattan"
        },
        {
            "disabled": false,
            "value": "The Electric City"
        }
    ]
}'

Response Example

200 - Success

{"options":[{"disabled":false,"id":"10001","value":"Scranton"},{"disabled":true,"id":"10002","optionId":"10000","value":"Manhattan"},{"disabled":false,"id":"10003","value":"The Electric City"}]}

Modified at 2025-07-16 07:18:01

Get custom field options (context)

Update custom field options (context)