For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationAPI referenceRelease notes
DocumentationAPI referenceRelease notes
  • Introduction
    • Overview
    • Authentication
  • Guides
    • Operations Manager search APIs
    • Search API
    • URL query parameters
    • Use query parameters in API requests
  • Reference
        • POSTCreate a group
        • POSTCreate a role
        • DELDelete a group
        • DELDelete a role
        • GETExtract CSV data of accounts, groups, and roles
        • POSTForce a user to log out
        • GETGet a list of groups
        • GETGet a list of methods
        • GETGet a list of roles
        • GETGet a list of views
        • GETGet a simplified list of groups
        • GETGet an individual account
        • GETGet an individual group
        • GETGet an individual role
        • GETList all accounts
        • PATCHUpdate a group
        • PATCHUpdate a role
        • PATCHUpdate an account
LogoLogo
Open sourceSupportFAQsDocs Home
ReferenceAuthorization

Update a role

PATCH
http://localhost:3000/authorization/roles/:roleId
PATCH
/authorization/roles/:roleId
$curl -X PATCH http://localhost:3000/authorization/roles/roleId \
> -H "Content-Type: application/json" \
> -u "<username>:<password>" \
> -d '{}'
1{
2 "status": "OK",
3 "message": "A sample success message",
4 "data": {
5 "provenance": "Custom",
6 "name": "role_1",
7 "description": "description of role_1",
8 "allowedMethods": [
9 {
10 "name": "methodName",
11 "provenance": "ApplicationName"
12 }
13 ],
14 "allowedViews": [
15 {
16 "path": "/manual/task/path",
17 "provenance": "ApplicationName"
18 }
19 ],
20 "_meta": {
21 "created": "2018-08-02T15:56:12.912Z",
22 "updated": "2018-08-02T15:56:12.912Z"
23 }
24 }
25}
Updates a role.
Was this page helpful?
Previous

Update an account

Next
Built with

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

roleIdstringRequired
The individual role to update.

Request

request body
updatesobjectOptional

Response

The output of the role update.
statusenum
The status of the API request.
Allowed values:
messagestring
Message containing either confirmation of the operation or the reason for the failure of the operation.
dataobject
This is the schema for an IAP role stored in Mongo

Errors

500
Internal Server Error