Delete Folder

Delete a folder from your workspace.

DELETE/folders/:id

Folders feature

Folders require the Folders feature to be enabled on your workspace plan. If disabled, this endpoint returns a 403 error.

Headers

Header	Required	Description
X-API-Key	Required	Your API key
QR-Version	Optional	API version (e.g., 2026-02-16)

Path Parameters

Parameter	Type	Description
id	string	The folder ID

Request

cURL

curl -X DELETE "https://integration-api.qr-build.com/folders/fld-aBc123XyZ9" \
  -H "X-API-Key: qrb_live_your_api_key_here"

JavaScript

const response = await fetch(
  "https://integration-api.qr-build.com/folders/fld-aBc123XyZ9",
  {
    method: "DELETE",
    headers: { "X-API-Key": "qrb_live_your_api_key_here" },
  }
);

Python

import requests

response = requests.delete(
    "https://integration-api.qr-build.com/folders/fld-aBc123XyZ9",
    headers={"X-API-Key": "qrb_live_your_api_key_here"},
)

Response

Returns 204 No Content with an empty body on success.

Error — Folder Not Found

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Folder not found"
  }
}

Error — Folders Not Available

{
  "success": false,
  "error": {
    "code": "FEATURE_DISABLED",
    "message": "Folders feature is not available for this workspace"
  }
}