# Delete a folder

**Publié le** : 2026-05-08
**Catégorie** : Media & Files

## `DELETE /media-folders/:id`

**Delete a folder**

Deletes a folder. You must specify what happens to contained files
via the `action` parameter: `move` (to parent) or `delete` (permanently).

Required permissions: `media.delete`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes | Unique identifier |


### Responses

| Status | Description |
| --- | --- |
| `204` | Deleted (no body) |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |
| `404` | Not found |


### Examples

```bash
curl -X DELETE "https://api.lynkow.com/v1/media-folders/f1a2b3c4-d5e6-7890-abcd-ef1234567890?action=move" \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "message": "Folder deleted"
}
```

---