---
title: "Deleted users"
slug: "deleted-users"
updated: 2024-10-25T14:27:47Z
published: 2024-10-25T14:27:47Z
canonical: "docs.voiso.com/deleted-users"
---

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

# Deleted users

The **deleted_users** API is part of Voiso's User Management APIs. Use it to obtain a list of agent names and IDs for all the **previously deleted** agents. Please refer to the detailed API endpoint specification [here](/v1-api/apidocs/deleted-users).

## Making requests

### Authentication

The **deleted_users** API requires the [base URL](/v1-api/apidocs/base-endpoint) and the [user API key](/v1-api/apidocs/authentication).

### Request parameters

The **deleted_users** API uses the `key` parameter: the [user API key](/v1-api/apidocs/authentication) representing the user making the request. Based on the user's permissions configured, Voiso provides the data allowed for that particular user.

HTTP request example:

```
https://cluster1.voiso.com/api/v2/cdr/deleted_agents
    ?key=cc7c76b8987a27ab5...b89b00ab6c3
```

JSON request example:

```
{
  "method": "GET",
  "url": "https://cluster1.voiso.com/api/v2/cdr/deleted_agents",
  "params": {
    "key": "cc7c76b8987a27ab5...b89b00ab6c3"
  }
}
```

## Response

The following table describes the elements of the response.

| Element | Description | Type | Notes |
| --- | --- | --- | --- |
| id | The ID assigned by the system when the user is created. | number |  |
| name | The name of the former user. | string |  |

### Response sample

```
[
  {
    "id": 28982
    "name": "Roberta Ride",
  }
]
```

## Troubleshooting

The following issues are sometimes encountered:

### Invalid User API Key

The **deleted users** API requires the user API key to validate the request. If you see this error, `"error": "Invalid User API Key"`, check that you use the correct user API key. For more information about API keys, refer to [Authentication](/v1-api/apidocs/authentication).