Add a child option to a cascading type field via Jira REST API

Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.

Summary

Formatting the JSON payload correctly can be challenging when trying to create a child option on a cascading type field via Jira REST API using the Create custom field options (context) endpoint.

Solution

Create child options by specifying the parent optionId.

Example:

{ "options": [ { "disabled": false, "value": "Scranton" }, { "optionId": "10113", "disabled": false, "value": "Manhattan" } ] }

The JSON data above creates two options: one parent option (Scranton) and one child option (Manhattan) that is a child of a parent with "optionId":"10113."

Updated on September 25, 2025

Still need help?

The Atlassian Community is here for you.