Authentication And Authorizati...
Role Management
Create App Role
1min
POST
https://{tenantSubdomain}.getos1.com/core/api/v1/aaa/apps/{appId}/roles
PATH PARAMETERS
appId
string
*HEADER PARAMETERS
X-COREOS-REQUEST-ID
string
*Unique request ID
X-COREOS-ACCESS
string
*Core-os access token
X-COREOS-AUTH
string
Core-os authentication token.
X-COREOS-USERINFO
string
User info
X-COREOS-TID
string
*Tenant ID
BODY PARAMETERS
body
RoleCreateRequest
*roleName
string
*Name of the role (each role should be assigned with a name).
description
string
*Description of the role, for example, role created for admin users.
securityLevel
string<SENSITIVE | RESTRICTED | OPEN>
Security level of the the role. Default is OPEN. Used to restrict the access level for the role.
permissions
string[]
Permissions attached with the role.
canGrantToApps
boolean
Boolean value indicates if the role can be granted to other apps/services.
canGrantToUsers
boolean
Boolean value indicates if the Role can be granted to user groups.
RESPONSES
201
OK - The request succeeded.
SuccessResponse
[All Of:ErrorResponseobject]error
Error
Information of error occurred during operation.
request
Request
data
object
request
Request
400
Bad request - The server is unable to process the request due to something that is perceived to be a client error.
ErrorResponse
error
Error
Information of error occurred during operation.
request
Request
401
Unauthorized - The client's identity is unknown to the server. Verify that you are accessing the correct tenant and that your client ID and client secret are valid on that Tenant.
ErrorResponse
error
Error
Information of error occurred during operation.
request
Request
403
Forbidden - The client's identity is known to the server but it does not have access rights to the requested resource. Verify that you're using the correct client ID and client secret or grant the client the necessary roles to access the resource.
ErrorResponse
error
Error
Information of error occurred during operation.
request
Request
404
Not found - The server can not find the requested resource.
ErrorResponse
error
Error
Information of error occurred during operation.
request
Request
503
Server error - The server is not ready to handle the request. This could be due to maintenance downtime or system resource constraints.
ErrorResponse
error
Error
Information of error occurred during operation.
request
Request


Updated 30 Oct 2023
Did this page help you?