Replace a Role

PUT {{baseUrl}}/api/v1/iam/roles/:roleIdOrLabel

Replaces a role by roleIdOrLabel

Request Body

{"label"=>"UserCreator", "description"=>"Create users", "permissions"=>["okta.users.create", "okta.users.read", "okta.groups.read", "okta.users.userprofile.manage"]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"id":"cr0Yq6IJxGIr0ouum0g3","label":"UserCreator","description":"Create users","created":"2021-02-06T16:20:57.000Z","lastUpdated":"2021-02-06T16:20:57.000Z","_links":{"permissions":{"href":"https://{yourOktaDomain}/api/v1/iam/roles/cr0Yq6IJxGIr0ouum0g3/permissions"},"self":{"href":"https://{yourOktaDomain}/api/v1/iam/roles/cr0Yq6IJxGIr0ouum0g3"}}}