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

# Delete a User

> Delete a user by ID or name, with soft/hard delete options

# Delete a User

Delete a user by ID or fully qualified name. Supports soft delete (default), hard delete, and restore operations.

## Delete by ID

**id** `string` *required*

UUID of the user to delete.

**recursive** `boolean` (default: false)

Recursively delete child entities.

**hardDelete** `boolean` (default: false)

Permanently delete the user. If `false`, the user is soft-deleted and can be restored.

## Delete by Name

Use `DELETE /v1/users/name/{fqn}` to delete by fully qualified name.

**fqn** `string` *required*

Fully qualified name of the user, for example `aaron_johnson0`.

**recursive** `boolean` (default: false)

Recursively delete child entities.

**hardDelete** `boolean` (default: false)

Permanently delete the user.

## Restore a Soft-Deleted User

Use `PUT /v1/users/restore` to restore a soft-deleted user.

**id** `string` *required*

UUID of the soft-deleted user to restore.

```python DELETE /v1/users/{id} theme={null}
from metadata.sdk import configure
from metadata.sdk.entities import Users

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Soft delete by ID
Users.delete("77655e6e-ad33-49da-bbca-db4ba4d4e2cd")

# Hard delete
Users.delete(
    "77655e6e-ad33-49da-bbca-db4ba4d4e2cd",
    hard_delete=True
)

# Delete by name
Users.delete(Users.retrieve_by_name("aaron_johnson0").id)

# Delete by name with options
Users.delete(
    Users.retrieve_by_name("aaron_johnson0").id,
    hard_delete=True
)

# Restore a soft-deleted user
Users.restore("77655e6e-ad33-49da-bbca-db4ba4d4e2cd")
```

```java DELETE /v1/users/{id} theme={null}
import java.util.Map;

// client is an initialized OpenMetadataClient.
var id = "77655e6e-ad33-49da-bbca-db4ba4d4e2cd";

// Soft delete
client.users().delete(id);

// Restore
client.users().restore(id);

// Hard delete
client.users().delete(id, Map.of("hardDelete", "true"));

// Delete by name: look up the ID first
var user = client.users().getByName("aaron_johnson0");
client.users().delete(user.getId().toString());
```

```bash DELETE /v1/users/{id} theme={null}
# Soft delete by ID
curl -X DELETE "{base_url}/api/v1/users/77655e6e-ad33-49da-bbca-db4ba4d4e2cd" \
  -H "Authorization: Bearer {access_token}"

# Hard delete
curl -X DELETE "{base_url}/api/v1/users/77655e6e-ad33-49da-bbca-db4ba4d4e2cd?hardDelete=true" \
  -H "Authorization: Bearer {access_token}"

# Delete by name
curl -X DELETE "{base_url}/api/v1/users/name/aaron_johnson0" \
  -H "Authorization: Bearer {access_token}"

# Restore soft-deleted user
curl -X PUT "{base_url}/api/v1/users/restore" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"id": "77655e6e-ad33-49da-bbca-db4ba4d4e2cd"}'
```

```json Response (Soft Delete) theme={null}
{
  "id": "77655e6e-ad33-49da-bbca-db4ba4d4e2cd",
  "name": "aaron_johnson0",
  "fullyQualifiedName": "aaron_johnson0",
  "displayName": "Aaron Johnson",
  "version": 0.2,
  "updatedAt": 1769982624214,
  "updatedBy": "admin",
  "email": "aaron_johnson0@gmail.com",
  "isBot": false,
  "isAdmin": false,
  "allowImpersonation": false,
  "teams": [
    {
      "id": "7a2b921b-f623-4eb5-9736-649788ad842c",
      "type": "team",
      "name": "Sales",
      "fullyQualifiedName": "Sales"
    }
  ],
  "deleted": true,
  "roles": [
    {
      "id": "761c2bb2-0b77-4bc5-9af9-cf89536d6a12",
      "type": "role",
      "name": "DataSteward",
      "fullyQualifiedName": "DataSteward"
    }
  ],
  "domains": []
}
```

***

## Returns

Soft delete returns the user object with `deleted: true`. Hard delete returns no content (204). Restore returns the restored user object.

***

## Error Handling

| Code | Error Type | Description |
| - | - | - |
| `401` | `UNAUTHORIZED` | Invalid or missing authentication token |
| `403` | `FORBIDDEN` | User lacks permission to delete this user |
| `404` | `NOT_FOUND` | User with given ID or FQN does not exist |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.