Reorder custom field options (context)

Changes the order of custom field options or cascading options in a context.

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.

curl --location --request PUT 'http://jira.local:8080/jira/rest//rest/api/3/field//context//option/move' \ --header 'Content-Type: application/json' \ --data-raw '{ "customFieldOptionIds": [ "10001", "10002" ], "position": "First" }'

Request

Path Params

fieldId

string

required

The ID of the custom field.

contextId

integer

required

The ID of the context.

Body Params application/json

An ordered list of custom field option IDs and information on where to move them.

after

string

write-onlyoptional

The ID of the custom field option or cascading option to place the moved options after. Required if position isn't provided.

customFieldOptionIds

array[string]

write-onlyrequired

A list of IDs of custom field options to move. The order of the custom field option IDs in the list is the order they are given after the move. The list must contain custom field options or cascading options, but not both.

position

enum<string>

write-onlyoptional

The position the custom field options should be moved to. Required if after isn't provided.

Allowed values:

FirstLast

Examples

Responses

🟢204Returned if options are reordered.

application/json

Body

No schema defined

🟠400Returned if the request is not valid.

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

🟠403Returned if the user does not have the necessary permission.

🟠404Returned if the field, the context, or one or more of the options is not found..