---
title: "Delete folder"
method: DELETE
path: "/v1/folders/{folder_id}"
tags: ["Folders"]
---

# Delete folder

`DELETE /v1/folders/{folder_id}`

Delete a folder. Optionally delete all workflows in the folder.

## Path parameters

- `folder_id` string, required — Folder ID

## Query parameters

- `delete_workflows` boolean — If true, also delete all workflows in this folder

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Response `200`

Successfully deleted folder

- object

## Other responses

- `404` — Folder not found
- `422` — Validation Error

## Changes

- **2026-06-13** `e7044f43e57e` — 2 info
  - api tag `Folders` added
  - api tag `Agent Folders` removed
- **2026-06-07** `e37d309fc58f` — 2 info
  - api tag `Agent Folders` added
  - api tag `Workflow Folders` removed
- **2026-04-02** `1da58db79a48` — 1 info
  - endpoint added
- **2026-04-01** `8a4e8b880de8` — 1 breaking
  - api path removed without deprecation
- **2026-04-01** `1da58db79a48` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/skyvern-ai/apis/skyvern-api/changes/v1/folders/:folder_id/delete.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api.md) · [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api/revisions/1a7ff4f208ff/schema)