Authentication And Authorizati...
Role Management

Create App Role

1min
POST
https://{tenantSubdomain}.getos1.com/core/api/v1/aaa/apps/{appId}/roles
This endpoint creates an App Role. Role is a generic representation of a set of permissions or resources of a specific app or service. Please note that requests that exceed the 375KB size limit will be rejected. Avoid passing large payloads to prevent exceeding this limit.
Path Parameters
appId
*
Header Parameters
X-COREOS-REQUEST-ID
*
X-COREOS-ACCESS
*
X-COREOS-AUTH
X-COREOS-USERINFO
X-COREOS-TID
*
Body Parameters
body
*
roleName
*
description
*
securityLevel
permissions
canGrantToApps
canGrantToUsers
Responses
201
OK - The request succeeded.
All Of
ErrorResponse +
error
request
data
request
400
Bad request - The server is unable to process the request due to something that is perceived to be a client error.
error
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.
error
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.
error
request
404
Not found - The server can not find the requested resource.
error
request
503
Server error - The server is not ready to handle the request. This could be due to maintenance downtime or system resource constraints.
error
request
Curl
JS
Ruby
Python
Responses
201
400
401
403
404
503