Update custom role | LaunchDarkly

curl -X PATCH https://app.launchdarkly.com/api/v2/roles/customRoleKey \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "patch": [
    {
      "op": "add",
      "path": "/policy/0",
      "value": null
    }
  ]
}'

{
  "_id": "1234a56b7c89d012345e678f",
  "_links": {},
  "key": "example-custom-role",
  "name": "Example custom role",
  "policy": [
    {
      "effect": "allow",
      "resources": [
        "proj/*:env/*;qa_*:/flag/*"
      ],
      "notResources": [
        "string"
      ],
      "actions": [
        "*"
      ],
      "notActions": [
        "string"
      ]
    }
  ],
  "_access": {
    "denied": [
      {
        "action": "string",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "string"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string"
          ],
          "role_name": "string"
        }
      }
    ],
    "allowed": [
      {
        "action": "string",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "string"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string"
          ],
          "role_name": "string"
        }
      }
    ]
  },
  "description": "This custom role is just an example",
  "basePermissions": "reader",
  "resourceCategory": "string",
  "assignedTo": {
    "membersCount": 1,
    "teamsCount": 1
  },
  "_presetBundleVersion": 1,
  "_presetStatements": [
    {
      "effect": "allow",
      "resources": [
        "proj/*:env/*;qa_*:/flag/*"
      ],
      "notResources": [
        "string"
      ],
      "actions": [
        "*"
      ],
      "notActions": [
        "string"
      ]
    }
  ]
}

Update a single custom role. Updating a custom role uses a [JSON patch](https://datatracker.ietf.org/doc/html/rfc6902) or [JSON merge patch](https://datatracker.ietf.org/doc/html/rfc7386) representation of the desired changes. To learn more, read [Updates](https://launchdarkly.com/docs/api#updates).<br/><br/>To add an element to the `policy` array, set the `path` to `/policy` and then append `/<array index>`. Use `/0` to add to the beginning of the array. Use `/-` to add to the end of the array.

curl -X PATCH https://app.launchdarkly.com/api/v2/roles/customRoleKey \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "patch": [
    {
      "op": "add",
      "path": "/policy/0",
      "value": null
    }
  ]
}'

{
  "_id": "1234a56b7c89d012345e678f",
  "_links": {},
  "key": "example-custom-role",
  "name": "Example custom role",
  "policy": [
    {
      "effect": "allow",
      "resources": [
        "proj/*:env/*;qa_*:/flag/*"
      ],
      "notResources": [
        "string"
      ],
      "actions": [
        "*"
      ],
      "notActions": [
        "string"
      ]
    }
  ],
  "_access": {
    "denied": [
      {
        "action": "string",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "string"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string"
          ],
          "role_name": "string"
        }
      }
    ],
    "allowed": [
      {
        "action": "string",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "string"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string"
          ],
          "role_name": "string"
        }
      }
    ]
  },
  "description": "This custom role is just an example",
  "basePermissions": "reader",
  "resourceCategory": "string",
  "assignedTo": {
    "membersCount": 1,
    "teamsCount": 1
  },
  "_presetBundleVersion": 1,
  "_presetStatements": [
    {
      "effect": "allow",
      "resources": [
        "proj/*:env/*;qa_*:/flag/*"
      ],
      "notResources": [
        "string"
      ],
      "actions": [
        "*"
      ],
      "notActions": [
        "string"
      ]
    }
  ]
}

Update a single custom role. Updating a custom role uses a JSON patch or JSON merge patch representation of the desired changes. To learn more, read Updates.

To add an element to the policy array, set the path to /policy and then append /<array index>. Use /0 to add to the beginning of the array. Use /- to add to the end of the array.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

customRoleKeystringRequiredformat: "string"

The custom role key

Request

This endpoint expects an object.

patchlist of objectsRequired

A JSON patch representation of the change to make

commentstringOptional

Optional comment

Response

Custom role response

_idstring

The ID of the custom role

_linksmap from strings to objects

The location and content type of related resources

keystring

The key of the custom role

namestring

The name of the custom role

policylist of objects

An array of the policies that comprise this custom role

_accessobject

Details on the allowed and denied actions for this custom role

descriptionstring

The description of the custom role

basePermissionsstring

Base permissions to use for this role. Defaults to no_access (older roles defaulted to reader). Recommended to set this to no_access in all cases.

resourceCategorystring

The category of resources this role is intended to manage. Can be organization, project, or any. Once set, this field cannot be changed.

assignedToobject

The number of teams and members this role is assigned to

_presetBundleVersioninteger

If created from a preset, the preset bundle version

_presetStatementslist of objects

If created from a preset, the read-only statements copied from the preset

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

$	curl -X PATCH https://app.launchdarkly.com/api/v2/roles/customRoleKey \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"patch": [
>	{
>	"op": "add",
>	"path": "/policy/0",
>	"value": null
>	}
>	]
>	}'

1	{
2	"_id": "1234a56b7c89d012345e678f",
3	"_links": {},
4	"key": "example-custom-role",
5	"name": "Example custom role",
6	"policy": [
7	{
8	"effect": "allow",
9	"resources": [
10	"proj/:env/;qa_:/flag/"
11	],
12	"notResources": [
13	"string"
14	],
15	"actions": [
16	"*"
17	],
18	"notActions": [
19	"string"
20	]
21	}
22	],
23	"_access": {
24	"denied": [
25	{
26	"action": "string",
27	"reason": {
28	"effect": "allow",
29	"resources": [
30	"proj/:env/;qa_:/flag/"
31	],
32	"notResources": [
33	"string"
34	],
35	"actions": [
36	"*"
37	],
38	"notActions": [
39	"string"
40	],
41	"role_name": "string"
42	}
43	}
44	],
45	"allowed": [
46	{
47	"action": "string",
48	"reason": {
49	"effect": "allow",
50	"resources": [
51	"proj/:env/;qa_:/flag/"
52	],
53	"notResources": [
54	"string"
55	],
56	"actions": [
57	"*"
58	],
59	"notActions": [
60	"string"
61	],
62	"role_name": "string"
63	}
64	}
65	]
66	},
67	"description": "This custom role is just an example",
68	"basePermissions": "reader",
69	"resourceCategory": "string",
70	"assignedTo": {
71	"membersCount": 1,
72	"teamsCount": 1
73	},
74	"_presetBundleVersion": 1,
75	"_presetStatements": [
76	{
77	"effect": "allow",
78	"resources": [
79	"proj/:env/;qa_:/flag/"
80	],
81	"notResources": [
82	"string"
83	],
84	"actions": [
85	"*"
86	],
87	"notActions": [
88	"string"
89	]
90	}
91	]
92	}