Description
Updates a Role.
Resource URL
PUT https://api.socialidnow.com/v1/rbac/roles/:role_id
Parameters
URL Parameters
role_id
|
required
|
role identifier.
|
JSON Parameters
role
|
required
|
a hash in the format field:value, with the necessary fields to update the role:
|
name
|
optional
|
role name.
|
login_app_id
|
optional
|
application identifier.
|
description
|
optional
|
role description.
|
Authentication
This API requires Account authentication. See Authentication.
Response
Response Status
ok (200)
|
The role was updated successfully.
|
bad_request (400)
|
Some required parameter was not informed.
|
unauthorized (401)
|
The authentication is wrong. See Authentication.
|
forbidden (403)
|
The account does not have access to this role or application.
|
unprocessable_entity (422)
|
Validation error in the field "role".
|
internal_server_error (500)
|
An unknown error happened.
|
Examples
Request
curl -iX PUT 'https://api.socialidnow.com/v1/rbac/roles/1' \
-d '{
"role": {
"name":"New Name",
"login_app_id":200,
"description":"New Description"
}
}' \
-H 'Content-type: application/json' \
--user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
Response
HTTP/1.1 200 Ok
Status: 200