Add a Value to a Set

Get the ID of the project where you want to add a value to the set. For instructions, see Get a Project ID. This example uses the project Test Project with the entity ID 81-0.

Get the list of all custom fields attached to the target project using the project ID you retrieved.

In the fields request parameter, you instruct the server to return the ID and name attributes of each custom field.

In the response to this request, the server returns the following data:

Locate the ID of the target custom field. This example uses the field Fix versions with the entity ID 82-4.

To form the URL for the final POST request, you need to check the attributes of the target field type. You can find the field type in the response with the list of all project custom fields you got earlier.

In this case, the field Fix versions is of VersionProjectCustomField type. Since you want to update the field bundle, you need the bundle attribute.

A bundle as an entity has its own attributes which you can check according to the bundle type.

In this case, the bundle of a VersionProjectCustomField is a VersionBundle. Since you want to update the set of its values, you need the values attribute.

Form the full request URL:

In the fields request parameter, you instruct the server to return the ID and the name of the value that you add.

To form a body for your POST request, you need to check the attributes of the element that you’re adding. In this case, a VersionBundle contains an array of VersionBundleElements as values, so you need to add one more VersionBundleElement to the array. The only attribute that you need to set is the name of the new value:

Notice that you must include the $type parameter in each request. For more information about $type in POST requests, check the documentation.

Add a new value to the bundle of the target custom field with a POST request:

If the request is successful, you’ll get the following response:

It contains the ID, name, and type of the added value.