List the current user folders

Returns all folders owned by the current user, ordered by created_at desc. Not paginated.

Required scope: form:read.

GET /api/v1/folders

List the current user folders

cURL

curl --request GET \
  --url https://formhug.ai/api/v1/folders \
  --header 'Authorization: Bearer <token>'

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.

Response

200

application/json

Success

data · object[] · required

Show child attributes