---
title: "Delete a folder"
method: POST
path: "/folders/delete"
tags: ["Organizing locations", "Folders"]
---

# Delete a folder

`POST /folders/delete`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/folders/delete`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/folders/delete/post.ts> (a function with typed inputs; its response is checked against the schema)

This API deletes a specified folder from the account. This action is irreversible.

**Behavior:**
- Any locations within the folder will be unassigned but not archived.
- Once deleted, the folder cannot be restored.

## Headers

- `Authorization` string

## Request body

- object
  - `input` object, required
    - `name` string, required: The name of the folder to delete

## Response `200`

Folder successfully deleted

- object
  - `data` object
    - `deleteFolder` object
      - `errors` unknown
      - `success` boolean: Indicates if the deletion was successful

## Other responses

- `400`: Bad request - folder name is invalid or missing
- `403`: Unauthorized - insufficient permissions to delete folder
- `404`: Folder not found

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)