---
title: Delete RBAC Group
url: https://platform.claude.com/docs/en/api/php/organization/rbac_groups/delete
---

# Delete RBAC Group

`$client->organization->rbacGroups->delete(string rbacGroupID): DeletedRBACGroup`

**DELETE** `/v1/organizations/rbac_groups/{rbac_group_id}`

Delete an RBAC Group. Groups provisioned by an identity provider (source type `"scim"`) cannot be deleted via the API while an organization in the tenant uses SCIM provisioning.

The RBAC Groups API is available to Claude Enterprise organizations only.

## Parameters

- `rbacGroupID: string` (path parameter)

  ID of the RBAC Group.

## Returns

- `class DeletedRBACGroup`

  - `"rbac_group_deleted" type`

    Deleted object type.

    For RBAC Groups, this is always `"rbac_group_deleted"`.

  - `string id`

    ID of the RBAC Group.

## Errors

Any method can also return the general [HTTP errors](https://platform.claude.com/docs/en/api/errors?sdk_languages=php).

- `RBACGroupGrantsOwnerAccessException` (HTTP status 400, error code `rbac_group_grants_owner_access`)

  A role attached to an RBAC Group in the request grants owner access, so this API does not add members to that group (directly or through an invite), remove its members, or delete it. Make the change in the organization's admin settings in Claude.

- `RBACGroupOwnerAccessUnconfirmedException` (HTTP status 400, error code `rbac_group_owner_access_unconfirmed`)

  The API could not finish checking whether an RBAC Group in the request grants owner access, so it made no change. Retrying the same request will not help. Make the change in the organization's admin settings in Claude.

- `SandboxEgressRestrictedException` (HTTP status 403, error code `sandbox_egress_restricted`)

  The request came from a Claude sandbox with restricted network access, which is not allowed to make this request. Send it from outside the sandbox, or from a sandbox with unrestricted network access.

## Example

```php
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Anthropic\Client;

$client = new Client(apiKey: 'my-anthropic-api-key');

$deletedRBACGroup = $client->organization->rbacGroups->delete('rbac_group_id');

var_dump($deletedRBACGroup);
```

### Response (200)

```json
{
  "id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
  "type": "rbac_group_deleted"
}
```
