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

# Delete Users From Workspace

The `deleteUsersFromWorkspace` mutation removes one or more users from a workspace.

<Warning>
  This action is **irreversible**. Deleted users lose all role assignments, attributes, and access to the workspace. Make sure you have the correct user IDs before calling this mutation.
</Warning>

## Signature

```graphql theme={null}
deleteUsersFromWorkspace(ids: [ID!]!, workspaceID: ID!): DeleteUsersFromWorkspaceResponse!
```

## Arguments

<ParamField path="ids" type="[ID!]!" required>
  The IDs of the users to delete. Use [listUsers](/integrations/graphql-api/queries/user/list-users) to find user IDs.
</ParamField>

<ParamField path="workspaceID" type="ID!" required>
  The workspace to remove the users from.
</ParamField>

## Permissions

Requires `iam:delete` scoped to the target workspace.

## Response

<ParamField path="status" type="ResponseStatus!">
  Indicates whether the operation succeeded. See [ResponseStatus](/integrations/graphql-api/objects/response-status).
</ParamField>

## Usage example

```graphql theme={null}
mutation DeleteUsersFromWorkspace($ids: [ID!]!, $workspaceID: ID!) {
  deleteUsersFromWorkspace(ids: $ids, workspaceID: $workspaceID) {
    status {
      code
      message
    }
  }
}
```

<RequestExample>
  ```bash Request theme={null}
  curl -s -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <access_token>" \
    -d '{
      "query": "mutation DeleteUsersFromWorkspace($ids: [ID!]!, $workspaceID: ID!) { deleteUsersFromWorkspace(ids: $ids, workspaceID: $workspaceID) { status { code message } } }",
      "variables": {
        "ids": ["user_abc123", "user_def456"],
        "workspaceID": "workspace_123"
      }
    }' \
    https://{ACCOUNT}.askwisdom.ai/graphql
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": {
      "deleteUsersFromWorkspace": {
        "status": {
          "code": "OK",
          "message": "Users deleted successfully"
        }
      }
    }
  }
  ```
</ResponseExample>

## Related articles

<CardGroup cols={2}>
  <Card title="List users" icon="users" href="/integrations/graphql-api/queries/user/list-users">
    Query users before deleting them
  </Card>

  <Card title="Create users" icon="user-plus" href="/integrations/graphql-api/mutations/user/create-users">
    Provision new users in a workspace
  </Card>
</CardGroup>