> For the complete documentation index, see [llms.txt](https://docs.paveapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paveapi.com/integrations/developer-docs/sessions-1/delete-a-session.md).

# DELETE Session

{% hint style="warning" %}
You can only delete session that has not been started by the User, and the status is **`IDLE`**
{% endhint %}

```
https://openapi.paveapi.com/v1/sessions/:session_key
```

| Path Parameters   |        |                                                                |
| ----------------- | ------ | -------------------------------------------------------------- |
| **`session_key`** | string | Unique session\_key generated when the new session was created |

| Headers             |        |                                                    |
| ------------------- | ------ | -------------------------------------------------- |
| **`API-Key`**       | string | The API-Key that was provided for your account     |
| **`API-Token`**     | string | The API-Token used when the session was created    |
| **`API-Timestamp`** | string | UTC Datetime string, example: 2021-05-30T12:49:19Z |

#### Sample Response (200: Ok)

The session successfully deleted.

```
{
    "message": "Session :session_key has been successfully removed."
}
```

#### Sample Response (400: Bad Request)

The session was unable to be deleted.

```
{
    "message": "Session :session_key has been started and cannot be deleted."
}
```

#### Sample Response (404: Not Found)

The session was not found - please check if the **`session_key`** is correct.

```
{
    "message": "Session :session_key cannot be found."
}
```