Assets

Get all asset data for the tree

Changed on

Listing of all assets and asset folders in the system. <br> Returns only data which are relevant for the tree <br> You can use different query parameters to filter the assets and it is possible to exclude folders from the result completely

get/pimcore-studio/api/assets/tree

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /pimcore-studio/api/assets/tree
  • Auth: none declared

Query parameters

pageinteger required
Example:1

Page number

pageSizeinteger required
Example:10

Number of items per page

parentIdinteger
Example:1

Filter assets by parent id.

idSearchTermstring

Filter assets/data-objects by matching ids. As a wildcard * can be used

pqlQuerystring
Example:id = 69

Pql query filter

excludeFoldersboolean

Filter folders from result.

pathstring
Example:/path/to/folder

Filter by path.

pathIncludeParentboolean
Example:true

Include the parent item in the result.

pathIncludeDescendantsboolean
Example:true

Include all descendants in the result.

Response

asset_get_tree_success_description

totalItemsinteger required

Example response

{
  "totalItems": 666,
  "items": [
    {
      "id": 83,
      "parentId": 1,
      "path": "/path/to/element",
      "icon": {
        "type": "path",
        "value": "/path/to/icon"
      },
      "userOwner": 1,
      "userModification": 1,
      "locked": "locked",
      "creationDate": 221846400,
      "modificationDate": 327417600,
      "elementType": "asset",
      "customAttributes": {
        "icon": {
          "type": "path",
          "value": "/path/to/icon"
        },
        "tooltip": "<b>My Tooltip</b>",
        "additionalIcons": [
          "some_other_icon"
        ],
        "key": "my_custom_key",
        "additionalCssClasses": [
          "my_custom_class"
        ]
      },
      "type": "image",
      "filename": "cool.jpg",
      "mimeType": "image/jpeg",
      "fullPath": "/path/to/asset.jpg",
      "permissions": {
        "list": true,
        "view": true,
        "publish": true,
        "delete": true,
        "rename": true,
        "create": true,
        "settings": true,
        "versions": true,
        "properties": true
      },
      "width": 666,
      "height": 333,
      "imageThumbnailPath": "/path/to/element/hulk-smash.jpg"
    }
  ]
}

Changes

  • 81b097a1505fRevision changes
    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status