Revoke Permission From Users

Revoke Permission From Users

Revokes a specific permission from multiple users or service accounts

Request
URI
POST
https://{api_host}/api/v2/user/revoke/{permission}
COPY
Path Parameters
string
permission
Required

Permission to revoke from the accounts. Please note that 'host_tag_management' is the equivalent of the 'Source Tag Management' permission

Possible values are : log_management, dashboard_management, events_management, alerts_management, derived_metrics_management, host_tag_management, agent_management, token_management, ingestion, user_management, embedded_charts, metrics_management, external_links_management, application_management, batch_query_priority, saml_sso_management, monitored_application_service_management,
Request Body

List of users or service accounts which should be revoked by specified permission

Array of string of type(s) application/json
Optional 
[
    {}
]
Authentication
This operation uses the following authentication methods.
Responses
200

successful operation

Returns UserModel of type(s) application/json 
{
    "identifier": "string",
    "customer": "string",
    "ssoId": "string",
    "lastSuccessfulLogin": 0,
    "groups": [
        "string"
    ],
    "userGroups": [
        {
            "id": "04e5fd3a-c916-45aa-923c-2fa02e9eddac",
            "name": "string",
            "customer": "string",
            "users": [
                "string"
            ],
            "userCount": 0,
            "properties": {
                "nameEditable": false,
                "usersEditable": false,
                "rolesEditable": false
            },
            "description": "string",
            "roles": [
                "RoleDTO Object"
            ]
        }
    ],
    "roles": [
        {
            "sampleLinkedGroups": [
                "UserGroup Object"
            ],
            "linkedGroupsCount": 0,
            "sampleLinkedAccounts": [
                "string"
            ],
            "linkedAccountsCount": 0,
            "restrictedPermissions": [
                "string"
            ],
            "properties": {
                "nameEditable": false,
                "usersRemovable": false,
                "usersAddable": false,
                "permsEditable": false,
                "deletable": false
            },
            "permissions": [
                "string"
            ],
            "name": "string",
            "id": "string",
            "description": "string",
            "createdEpochMillis": 0,
            "lastUpdatedMs": 0,
            "lastUpdatedAccountId": "string",
            "customer": "string"
        }
    ]
}
string
identifier
Required

The unique identifier of this user, which must be their valid email address

string
customer
Required

The id of the customer to which this user belongs

string
ssoId
Optional

ssoId

integer As int64 As int64
lastSuccessfulLogin
Optional

lastSuccessfulLogin

array of string
groups
Required

The permissions granted to this user

array of object
userGroups
Required

The list of user groups the user belongs to

array of object
roles
Optional

roles


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/api/v2/user/revoke/{permission}
On This Page
User Operations
GET
Get All Users
POST
Create User
POST
Delete Multiple Users
POST
Grant Permission To Users
POST
Invite Users
POST
Revoke Permission From Users
POST
Validate Users
GET
Get User
PUT
Update User
DELETE
Delete User
POST
Add User To User Groups
GET
Get User Business Functions
POST
Grant User Permission
POST
Remove User From User Groups
POST
Revoke User Permission