---
title: "Delete folder by ID"
method: DELETE
path: "/files/2026-09/folders/{folderId}"
tags: ["Folders"]
---

# Delete folder by ID

`DELETE /files/2026-09/folders/{folderId}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/files/2026-09/folders/{folderId}`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `files.ui_hidden.write`

Delete a folder in your HubSpot account using its ID. This operation deletes the folder and its contents recursively.

## Path parameters

- `folderId` string, required

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-09** (2026-09) `8f8b7750e626`: 2 info
  - api tag `Folders` added
  - api tag `Basic` removed
- **2026-09-09** (2026-09) `6e0d1e97cb30`: 2 info
  - the security scope `files.ui_hidden.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `files.delete` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-09) `b2b4ca09ea8b`: 2 info
  - the security scope `files.ui_hidden.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `files.delete` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/files-files/changes/files/2026-09/folders/:folderId/delete.md)

---

[API](https://skmtc.dev/hubspot/apis/files-files.md) - [All operations](https://skmtc.dev/hubspot/apis/files-files/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/files-files/revisions/551d24894509?raw)