Customer.io
v1.0.0
OpenAPI 3.1.0

List file assets

US region

Client Libraries
Shell Curl

List file assets

​

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

Query Parameters
  • parent_folder_id
    Type: integer

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

  • direct_descendants_only
    Type: boolean

    If true, this returns only children of the parent folder.

  • page
    Type: integer
    min:  
    1

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

  • limit
    Type: integer
    min:  
    1
    max:  
    10000

    Limit the number of results per page.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/assets
curl 'https://api.customer.io/v1/assets?parent_folder_id=1&direct_descendants_only=false&page=1&limit=1000'

{
  "assets": [
    {
      "id": 1,
      "name": "string",
      "parent_folder_id": null,
      "path": "string",
      "size": 1,
      "created": 1773856017,
      "updated": 1773856017
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 1,
      "total": 1
    },
    "filters": {
      "parent_folder_id": null,
      "direct_descendants_only": true
    }
  }
}

A paginated list of file assets with metadata.