> ## Documentation Index
> Fetch the complete documentation index at: https://docs.falkordb.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Revoke user role

> Remove a user's access to a subscription.

Revokes a role previously granted with [Invite user](/api-reference/account/access/invite-user). The user immediately loses access to every deployment instance in the subscription.

## Authorization

<ParamField header="Cookie" type="string" required>
  Session cookie set by [Sign in](/api-reference/authentication/signin): `omnistrate_token=<jwt>`.
</ParamField>

## Path parameters

<ParamField path="subscriptionId" type="string" required>
  The subscription ID, for example `sub-abc123`.
</ParamField>

## Body

<ParamField body="email" type="string" required>
  Email address of the user whose role is revoked.
</ParamField>

<ParamField body="roleType" type="string" required>
  Role to revoke. One of `root`, `admin`, `editor`, `reader`, `service_editor`, `service_reader`, or `service_operator`.
</ParamField>

```json Request theme={null}
{
  "email": "ada@example.com",
  "roleType": "editor"
}
```

## Response

Returns `200 OK` with an empty body.

## Errors

See [Error](/api-reference/schemas#error) for the error response shape.