Assets

List file assets

Changed on

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

get/v1/assets

Request

  • Base URL
    https://api.customer.io
  • URL
    https://api.customer.io/v1/assets
  • 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 file assets with metadata.

Example response

{
  "assets": [
    {
      "created": 1773856017,
      "updated": 1773856017
    }
  ]
}

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

    • 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