Admin API patching request to update feature flag definition fails with 400 bad request

Problem

Admin APIs allows one to update existing feature flag definitions. When using the curl command below to add a key into an existing individual target section, it fails with 400 bad request.

curl -v -X PATCH -d '[{"op": "add", "path": "/treatments/0/keys/-", "value": "key1"}]' -H "Authorization: Bearer ADMIN API KEY" -H "Content-Type: application/json" https://api.split.io/internal/api/v2/splits/ws/[Workspace ID]/[Split Name]/environments/[Environment Name]

HTTP/2 400 
< strict-transport-security: max-age=15770000; includeSubDomains
< vary: Cookie
< content-length: 0

* Connection #0 to host api.split.io left intact

Root cause

The workspace configuration provides the admin the option to require title and comments for a feature flag, segment and metric changes via a checkbox option. If checked, it is required to provide a title and comment when changing the feature flag definition, in the user interface and Admin API.

Solution

Add the title and comment optional parameters in the URL query as below.

curl -v -X PATCH -d '[{"op": "add", "path": "/treatments/0/keys/-", "value": "key1"}]' -H "Authorization: Bearer ADMIN API KEY" -H "Content-Type: application/json" https://api.split.io/internal/api/v2/splits/ws/[Workspace ID]/[Split Name]/environments/[Environment Name]?title=Split-Engineer-Testing&comment=Split-Engineer-Testing-Comment