# delete_chat: Delete a chat

Delete one conversation. This action can change or spend something, and it happens right away. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/delete_chat
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "chatId": "PASTE_CHAT_ID_HERE"
}
```

## What you give it

- `chatId` (needed): a chat id. The conversation id (from list_chats). Where to get it: Run `list_chats` and use `chats[].id`.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `deleted`
- `chatId`
- `from`: the account it ran on
- `usedToday`: number
- `dailyLimit`: number

Page: https://heyreagent.com/docs/actions/delete_chat