Reorder custom field options (context)

PUT

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

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.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

204 - Example 1

null

Request

Path Params

Body Params application/json

Examples

Responses

🟢204No Content

application/json

Returned if options are reordered.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

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

Update custom field options (context)

Delete custom field options (context)