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

# Remove workspace member

DELETE https://host.com/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-platform/nemo-platform/documentation/reference/api-reference/entity-store/remove-workspace-member-apis-entities-v-2-workspaces-workspace-members-principal-id-delete

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: Nemo Platform API
  version: 1.0.0
paths:
  /apis/entities/v2/workspaces/{workspace}/members/{principal_id}:
    delete:
      operationId: >-
        remove-workspace-member-apis-entities-v-2-workspaces-workspace-members-principal-id-delete
      summary: Remove workspace member
      description: >-
        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

        ```
      tags:
        - subpackage_entityStore
      parameters:
        - name: workspace
          in: path
          required: true
          schema:
            type: string
        - name: principal_id
          in: path
          required: true
          schema:
            type: string
        - name: wait_role_propagation
          in: query
          description: >-
            If true, wait for roles to propagate before returning (default:
            true). Set to false for bulk operations.
          required: false
          schema:
            type: boolean
            default: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
servers:
  - url: https://host.com
    description: Default
components:
  schemas:
    DeleteResponse:
      type: object
      properties:
        message:
          type: string
          default: Resource deleted successfully.
        id:
          type: string
          description: The ID of the deleted resource.
        deleted_at:
          type: string
          format: date-time
          description: The timestamp when the resource was deleted.
      title: DeleteResponse
    ValidationErrorLocItems:
      oneOf:
        - type: string
        - type: integer
      title: ValidationErrorLocItems
    ValidationError:
      type: object
      properties:
        loc:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorLocItems'
        msg:
          type: string
        type:
          type: string
        input:
          description: Any type
        ctx:
          type: object
          additionalProperties:
            description: Any type
      required:
        - loc
        - msg
        - type
      title: ValidationError
    HTTPValidationError:
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      title: HTTPValidationError

```

## Examples



**Request**

```json
{}
```

**Response**

```json
{
  "message": "Member roles revoked and removed from workspace successfully.",
  "id": "user@example.com",
  "deleted_at": "2024-04-20T14:45:00Z"
}
```

**SDK Code**

```python
import requests

url = "https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id"

payload = {}
headers = {"Content-Type": "application/json"}

response = requests.delete(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id';
const options = {method: 'DELETE', headers: {'Content-Type': 'application/json'}, body: '{}'};

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

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.delete("https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id', [
  'body' => '{}',
  'headers' => [
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id");
var request = new RestRequest(Method.DELETE);
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Content-Type": "application/json"]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://host.com/apis/entities/v2/workspaces/workspace/members/principal_id")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "DELETE"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```