Skip to main content
POST
/
v2.0
/
users
/
{userId}
/
removerolefromuser
Removes an organisation-wide role from an user.
curl --request POST \
  --url 'https://api-trial.cognigy.ai/new/v2.0/users/{userId}/removerolefromuser?api_key=' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "role": "admin"
}
'
{
  "type": "Bad Request",
  "title": "Bad Request Error",
  "status": 400,
  "detail": "Validation failed. Missing payload.",
  "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432",
  "code": 1000,
  "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f",
  "details": {}
}

Authorizations

​
X-API-Key
string
header
required

Supply the API Key in the HTTP-Header

​
api_key
string
query
required

Supply the API Key in the Url-Query

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
Accept
enum<string>

The default media type is application/hal+json. Use application/json for pure data results.

Available options:
application/json,
application/hal+json,
application/xml,
text/xml,
text/csv

Path Parameters

​
userId
string
required

The Id of the User

Required string length: 24

Body

application/json
​
role
enum<string>
Available options:
admin,
apiKeys,
base_role,
basicSupportUser,
fullSupportUser,
liveAgentAdmin,
liveAgentAgent,
liveAgentSupervisor,
odata,
projectAssigner,
projectManager,
userManager,
userDetailsViewer,
voiceGatewayUser,
opsCenterUser

Response

User-role was removed from the user.