# DELETE /api/teams/{id}

> Team - Delete a Team

Soft delete. The team leaves every listing but stays in the database and can be restored by an administrator. The staff users themselves are not touched.

- **Endpoint:** `DELETE /api/teams/{id}`
- **Group:** Team
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/TeamController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | Number | yes | Team unique ID |

## Request example

```bash
curl -X DELETE "https://yoursite.com/index.php/api/teams/123" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
{ "status": 200, "messages": { "success": "The record has been deleted." } }
```

### Error - Error-Response:

```json
HTTP/1.1 400 Bad Request
{ "status": false, "messages": { "error": "This record can't be deleted" } }
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/team/delete-team/