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
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
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"}}}