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
    • Integration API routes
    • 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

Create a role

POST
http://localhost:3000/authorization/roles
POST
/authorization/roles
$curl -X POST http://localhost:3000/authorization/roles \
> -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}
Creates a role.
Was this page helpful?
Previous

Delete a group

Next
Built with

Authentication

AuthorizationBasic

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

Request

request body
roleobjectOptional
This is the schema for an IAP role stored in Mongo

Response

Result of role creation process
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