---
title: "Revoke permission"
method: DELETE
path: "/api/v2/roles/{role_id}/permissions"
tags: ["Roles"]
---

# Revoke permission

`DELETE /api/v2/roles/{role_id}/permissions`

Removes a permission from a role.

## Path parameters

- `role_id` string, required

## Request body

- RelationshipToPermission — Relationship to a permissions object.
  - `data` RelationshipToPermissionData — Relationship to permission object.
    - `id` string — ID of the permission.
    - `type` 'permissions' — Permissions resource type.

## Response `200`

OK

- PermissionsResponse — Payload with API-returned permissions.
  - `data` Permission[] — Array of permissions.
    - `attributes` PermissionAttributes — Attributes of a permission.
      - `created` string, date-time — Creation time of the permission.
      - `description` string — Description of the permission.
      - `display_name` string — Displayed name for the permission.
      - `display_type` string — Display type.
      - `group_name` string — Name of the permission group.
      - `name` string — Name of the permission.
      - `name_aliases` string[] — List of alias names for the permission.
      - `restricted` boolean — Whether or not the permission is restricted.
    - `id` string — ID of the permission.
    - `type` 'permissions', required — Permissions resource type.

## Other responses

- `400` — Bad Request
- `403` — Authentication error
- `404` — Not found
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)