> This page is for version 0.10.
> For other versions, use one of these documentation indexes:
> - Latest (default): https://docs.nvidia.com/nemo-helix/latest/llms.txt
> - 0.10: https://docs.nvidia.com/nemo-helix/v0.10/llms.txt
> - 0.9: https://docs.nvidia.com/nemo-helix/v0.9/llms.txt
> - 0.8: https://docs.nvidia.com/nemo-helix/v0.8/llms.txt
> - 0.7: https://docs.nvidia.com/nemo-helix/v0.7/llms.txt
> - 0.6: https://docs.nvidia.com/nemo-helix/v0.6/llms.txt
> - 0.5: https://docs.nvidia.com/nemo-helix/v0.5/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo-helix/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo-helix/_mcp/server.

# Remove workspace member

DELETE http://localhost:8080/apis/entities/v2/workspaces/{workspace}/members/{principal_id}

Remove a member from the workspace by revoking all their roles.

This revokes all active role bindings for the principal in the workspace.
By default, this endpoint waits for all roles to be revoked before returning.
Use `wait_role_propagation=false` to skip waiting (useful for bulk operations).

Example:
```
DELETE /apis/entities/v2/workspaces/ml-team/members/user@example.com
```

Reference: https://docs.nvidia.com/nemo-helix/documentation/reference/api-reference/entity-store/remove-workspace-member-apis-entities-v-2-workspaces-workspace-members-principal-id-delete

## Request

### Path parameters

- `workspace` (string, required)
- `principal_id` (string, required)

### Query parameters

- `wait_role_propagation` (boolean, optional, default: true) — If true, wait for roles to propagate before returning (default: true). Set to false for bulk operations.

## Response

### 200

Successful Response

- `id` (string, required) — The ID of the deleted resource.
- `message` (string, optional, default: Resource deleted successfully.)

## Errors

### 422 Unprocessable Entity Error

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)
- `input` (any, optional)
- `ctx` (map from string to any, optional)

### ValidationErrorLocItems

- string
- integer

## Examples

**Response**

```json
{
  "id": "string",
  "message": "Resource deleted successfully."
}
```

**SDK Code**

```python
import requests

url = "http://localhost:8080/apis/entities/v2/workspaces/workspace/members/principal_id"

response = requests.delete(url)

print(response.json())
```

```javascript
const url = 'http://localhost:8080/apis/entities/v2/workspaces/workspace/members/principal_id';
const options = {method: 'DELETE'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```