Update Folder

Update an existing folder's name.

PATCH/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
Content-Type	Required	application/json
QR-Version	Optional	API version (e.g., 2026-02-16)

Path Parameters

Parameter	Type	Description
id	string	The folder ID

Body Parameters

Parameter	Type	Required	Description
name	string	Required	New folder name (1–255 characters, leading/trailing spaces trimmed)

Request

cURL

curl -X PATCH "https://integration-api.qr-build.com/folders/fld-aBc123XyZ9" \
  -H "X-API-Key: qrb_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Campaign Name"
  }'

JavaScript

const response = await fetch(
  "https://integration-api.qr-build.com/folders/fld-aBc123XyZ9",
  {
    method: "PATCH",
    headers: {
      "X-API-Key": "qrb_live_your_api_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "Updated Campaign Name",
    }),
  }
);

Python

import requests

response = requests.patch(
    "https://integration-api.qr-build.com/folders/fld-aBc123XyZ9",
    headers={
        "X-API-Key": "qrb_live_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={"name": "Updated Campaign Name"},
)

Response

Returns 204 No Content with an empty body on success.

Error — Validation

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request body",
    "details": [
      { "field": "name", "message": "name is required" }
    ]
  }
}

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"
  }
}