CUcustomer
Assets

List folders

Changed on

Returns a paginated list of asset folders. Supports filtering by parent folder and choosing between direct children or the entire folder subtree.

get/v1/assets/folders

Request

  • Base URL
    https://api.customer.io
  • URL
    https://api.customer.io/v1/assets/folders
  • Auth
    none declared

Query parameters

parent_folder_idinteger

Filter results to a specific parent folder. Use 0 or omit to target the root level.

direct_descendants_onlyboolean

When true, the response includes only the immediate children of the parent folder. When false, it includes the parent folder's entire subtree.

pageinteger

The page number of results you want to display. Use with limit.

limitinteger

The maximum number of results per page.

Response

A paginated list of folders with metadata.

Example response

{
  "folders": [
    {
      "name": "Banners",
      "created": 1773856017,
      "updated": 1773856017
    }
  ]
}

Changes

  • b0a0db5fbc21Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 5da2740beeb5Revision changes
    • breaking

      the // response's property type changed from integer to string for status

    • breaking

      the // response's property type changed from integer to string for status

    • breaking

      the // response's property type changed from integer to string for status