Skip to main content

Revoke Role From Group (V2)

Revokes one directly assigned role from a SCIM group.

DELETE/v2/groups/{groupId}/roles/{roleId}
Connection Endpoint

The base URL for this API is in the following format:

https://api.cloud.zilliz.com

📘Notes

The endpoints on the control plane currently supports up to 20 requests per second per user per endpoint.

shell
export BASE_URL="https://api.cloud.zilliz.com"
Parameters
Authorizationstringheaderrequired

The authentication token should be an API key with appropriate privileges.

Example Value: Bearer {{TOKEN}}
groupIdstringpathrequired

The SCIM group ID.

Example Value: g-xxxxxxxxxxxxxx
roleIdstringpathrequired

The role ID.

Example Value: r-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
projectIdstringquery

Required when revoking a predefined project role.

Example Value: proj-xxxxxxxx
bash
export TOKEN="YOUR_API_KEY"
export groupId="g-xxxxxxxxxxxxxx"
export roleId="r-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl --request DELETE \
--url "${BASE_URL}/v2/groups/${groupId}/roles/${roleId}" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
Responses200 OK - application/json

Returns a successful result or an error message.

A successful response.

codeintegerrequired

The response code.

Example Value: 0
databooleanrequired

Whether the operation succeeded.

A failure response.

codeintegerrequired

The response code.

messagestringrequired

The error message.

Successjson
{
    "code": 0,
    "data": true
}
Ctrl I