Folders API

📡

Folders API

The Folders API is read-only. You can list folders to get their IDs for use with the Testimonials API folderId filter. Creating, renaming, and deleting folders is done through the Endors dashboard.

List folders

Returns all folders in the Space, ordered alphabetically by name.

Example request

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/folders" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/folders" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/folders" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

Response

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "name": "Homepage",
      "created_at": "2026-04-01T09:00:00.000Z",
      "updated_at": "2026-04-01T09:00:00.000Z"
    },
    {
      "id": "uuid",
      "name": "Pricing Page",
      "created_at": "2026-04-15T11:30:00.000Z",
      "updated_at": "2026-04-15T11:30:00.000Z"
    }
  ]
}

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "name": "Homepage",
      "created_at": "2026-04-01T09:00:00.000Z",
      "updated_at": "2026-04-01T09:00:00.000Z"
    },
    {
      "id": "uuid",
      "name": "Pricing Page",
      "created_at": "2026-04-15T11:30:00.000Z",
      "updated_at": "2026-04-15T11:30:00.000Z"
    }
  ]
}

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "name": "Homepage",
      "created_at": "2026-04-01T09:00:00.000Z",
      "updated_at": "2026-04-01T09:00:00.000Z"
    },
    {
      "id": "uuid",
      "name": "Pricing Page",
      "created_at": "2026-04-15T11:30:00.000Z",
      "updated_at": "2026-04-15T11:30:00.000Z"
    }
  ]
}

Response fields

Field	Type	Description
`id`	UUID	Use this as the `folderId` query parameter on the Testimonials endpoint
`name`	string	The folder name as shown in the dashboard
`created_at`	ISO 8601 string
`updated_at`	ISO 8601 string

Fetching testimonials in a folder

Use a folder's id with the Testimonials list endpoint:

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/testimonials?folderId=FOLDER_ID" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/testimonials?folderId=FOLDER_ID" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/testimonials?folderId=FOLDER_ID" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

If the folder exists but has no testimonials, the response is { "ok": true, "data": [] }.