---
# System prepended metadata

title: '`DELETE` /api/admin/tweets/:id'
tags: [API-doc]

---

# `DELETE` /api/admin/tweets/:id  

## API 功能  
刪除一筆推文。  
* 登入者必須是 Admin。  

## 前端傳入資料  
### parameters  
| name | description  | required |
| ---- | ------------ | -------- |
| `id` | tweet's `id` | true     |

### req.body  
None  

## 後端回傳資料  
### 驗證成功  
```javascript
// status code: 200
{
    "status": "success",
    "message": "1 tweet was deleted"
}
```
### 傳入資料格式有誤  
發生原因: 檢查後發現任一欄位為空。
```json
// status code: 400
{
    "status": "error",
    "message": "All fields are required."
}
```
### 驗證失敗  
發生原因: 使用一般使用者帳號登入或密碼錯誤。
```javascript
// status code: 401
{
    "status": "error",
    "message": "permission denied: need permission of admin"
}
```
發生原因: id 沒有正確傳入或找不到相關 tweet 資料。
```javascript
// status code: 404
{
    "status": "error",
    "message": "Invalid id parameter or no tweet was found"
}
```



## 相關連結  
* [回首頁](https://hackmd.io/@twitter-2022/index)  
* [API 總表](/Gl56cI2LQ5ObBpmQnbnphw)

###### tags: `API-doc`