Skip to content

Atlassian: Issue custom field options schemas

11 Atlassian schemas with complete fields and constraints.

← Issue custom field options operations · All schemas

Create custom field options (context) — request body — body

FieldTypePresenceDescription and constraints
$objectRootDetails of the options to create for a custom field.
write Only: true
Additional keys: not allowed
optionsarrayOptionalDetails of options to create.
options[]ModelEach itemExpand Create custom field options (context) — request body — body options item

Referenced models: Create custom field options (context) — request body — body options item

Create custom field options (context) — request body — body options item

FieldTypePresenceDescription and constraints
$objectRootDetails of a custom field option to create.
Additional keys: not allowed
disabledbooleanOptionalWhether the option is disabled.
optionIdstringOptionalFor cascading options, the ID of a parent option.
valuestringRequired within parentThe value of the custom field option.

Create custom field options (context) — response body

FieldTypePresenceDescription and constraints
$objectRootA list of custom field options for a context.
optionsJSONOptional
options (anyOf 1)arrayAlternativeThe created custom field options.
options (anyOf 1)[]ModelEach itemExpand Get custom field options (context) — response body — values The list of items item
options (anyOf 2)nullAlternative

Referenced models: Get custom field options (context) — response body — values The list of items item

Get custom field option — response body

FieldTypePresenceDescription and constraints
$objectRootDetails of a custom option for a field.
selfJSONOptional
self (anyOf 1)stringAlternativeThe URL of these custom field option details.
Format: uri
Read only: true
self (anyOf 2)nullAlternative
valueJSONOptional
value (anyOf 1)stringAlternativeThe value of the custom field option.
Read only: true
value (anyOf 2)nullAlternative

Get custom field options (context) — response body

FieldTypePresenceDescription and constraints
$objectRootA page of items.
isLastJSONOptional
isLast (anyOf 1)booleanAlternativeWhether this is the last page.
Read only: true
isLast (anyOf 2)nullAlternative
maxResultsJSONOptional
maxResults (anyOf 1)JSONAlternative
maxResults (anyOf 1) (anyOf 1)integerAlternativeThe maximum number of items that could be returned.
Format: int32
Read only: true
maxResults (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
maxResults (anyOf 2)nullAlternative
nextPageJSONOptional
nextPage (anyOf 1)stringAlternativeIf there is another page of results, the URL of the next page.
Format: uri
Read only: true
nextPage (anyOf 2)nullAlternative
selfJSONOptional
self (anyOf 1)stringAlternativeThe URL of the page.
Format: uri
Read only: true
self (anyOf 2)nullAlternative
startAtJSONOptional
startAt (anyOf 1)JSONAlternative
startAt (anyOf 1) (anyOf 1)integerAlternativeThe index of the first item returned.
Format: int64
Read only: true
startAt (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
startAt (anyOf 2)nullAlternative
totalJSONOptional
total (anyOf 1)JSONAlternative
total (anyOf 1) (anyOf 1)integerAlternativeThe number of items returned.
Format: int64
Read only: true
total (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
total (anyOf 2)nullAlternative
valuesJSONOptional
values (anyOf 1)arrayAlternativeThe list of items.
Read only: true
values (anyOf 1)[]ModelEach itemExpand Get custom field options (context) — response body — values The list of items item
values (anyOf 2)nullAlternative

Referenced models: Get custom field options (context) — response body — values The list of items item

Get custom field options (context) — response body — values The list of items item

FieldTypePresenceDescription and constraints
$objectRootDetails of the custom field options for a context.
disabledJSONOptional
disabled (anyOf 1)booleanAlternativeWhether the option is disabled.
disabled (anyOf 2)nullAlternative
idJSONOptional
id (anyOf 1)stringAlternativeThe ID of the custom field option.
id (anyOf 2)nullAlternative
optionIdJSONOptional
optionId (anyOf 1)stringAlternativeFor cascading options, the ID of the custom field option containing the cascading option.
optionId (anyOf 2)nullAlternative
valueJSONOptional
value (anyOf 1)stringAlternativeThe value of the custom field option.
value (anyOf 2)nullAlternative

Reorder custom field options (context) — request body — body

FieldTypePresenceDescription and constraints
$objectRootAn ordered list of custom field option IDs and information on where to move them.
Additional keys: not allowed
afterstringOptionalThe ID of the custom field option or cascading option to place the moved options after. Required if `position` isn't provided.
write Only: true
customFieldOptionIdsarrayRequired within parentA 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.
write Only: true
customFieldOptionIds[]stringEach itemwrite Only: true
positionstringOptionalThe position the custom field options should be moved to. Required if `after` isn't provided.
One of: First, Last
write Only: true

Update custom field options (context) — request body — body

FieldTypePresenceDescription and constraints
$objectRootDetails of the options to update for a custom field.
write Only: true
Additional keys: not allowed
optionsarrayOptionalDetails of the options to update.
options[]ModelEach itemExpand Update custom field options (context) — request body — body options item

Referenced models: Update custom field options (context) — request body — body options item

Update custom field options (context) — request body — body options item

FieldTypePresenceDescription and constraints
$objectRootDetails of a custom field option for a context.
Additional keys: not allowed
disabledbooleanOptionalWhether the option is disabled.
idstringRequired within parentThe ID of the custom field option.
valuestringOptionalThe value of the custom field option.

Update custom field options (context) — response body

FieldTypePresenceDescription and constraints
$objectRootA list of custom field options for a context.
optionsJSONOptional
options (anyOf 1)arrayAlternativeThe updated custom field options.
options (anyOf 1)[]ModelEach itemExpand Update custom field options (context) — response body — options The updated custom field options item
options (anyOf 2)nullAlternative

Referenced models: Update custom field options (context) — response body — options The updated custom field options item

Update custom field options (context) — response body — options The updated custom field options item

FieldTypePresenceDescription and constraints
$objectRootDetails of a custom field option for a context.
disabledJSONOptional
disabled (anyOf 1)booleanAlternativeWhether the option is disabled.
disabled (anyOf 2)nullAlternative
idJSONOptional
id (anyOf 1)stringAlternativeThe ID of the custom field option.
id (anyOf 2)nullAlternative
valueJSONOptional
value (anyOf 1)stringAlternativeThe value of the custom field option.
value (anyOf 2)nullAlternative

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.