Update a folder

Currently only the name can be updated. Other fields such as parent_folder_token are ignored.

Required scope: form:write.

PATCH /api/v1/folders/{token}

Update a folder

cURL

curl --request PATCH \
  --url https://formhug.ai/api/v1/folders/{token} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Renamed"
}
'

200

{
  "data": {
    "token": "KaB2c1",
    "name": "Work",
    "parent_folder_token": "<string>",
    "child_folder_count": 0,
    "child_form_count": 3,
    "created_at": "2026-05-12T08:00:00Z"
  }
}

Authorizations

Authorization · string · header · required

Personal Access Token prefixed with fh_. Sent as Authorization: Bearer fh_xxx. The scope required by each endpoint is listed in that endpoint's description.

Path Parameters

token · string · required

Folder token

Body

application/json

name · string

New folder name

Example:

"Renamed"

Response

200

application/json

Updated

data · object · required

Show child attributes