Asset - Fetch list of all available folders

Retrieves the folder and asset hierarchy for the current user's default tenant.

get

Authorizations

Bearer

HTTPRequired

Please enter a valid token

Query parameters

versionstringOptional

The requested API version

Default: 1.0

Header parameters

embedfast-user-idstringOptional

Optional User Id

Responses

200

Success: Successfully retrieved the folder-asset hierarchy.

text/plainapplication/jsontext/json

Represents a folder in the folder-asset hierarchy, including its child folders and assets.

folderIdstring · uuidOptional

Gets or sets the unique identifier for the folder.

namestring · nullableOptional

Gets or sets the name of the folder.

parentFolderIdstring · uuid · nullableOptional

Gets or sets the unique identifier of the parent folder, or null if this is a root folder.

400

Bad Request: The request is invalid due to syntax errors or incorrect/missing parameters.

text/plainapplication/jsontext/json

401

Unauthorized: Invalid credentials or missing/invalid authentication token.

text/plainapplication/jsontext/json

500

Internal Server Error: An unexpected error occurred or a server timeout.

text/plainapplication/jsontext/json

get

/assets/folderAssets

HTTPcURLJavaScriptPython

GET /assets/folderAssets HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "folderId": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "parentFolderId": "123e4567-e89b-12d3-a456-426614174000",
    "children": [
      {
        "folderId": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "parentFolderId": "123e4567-e89b-12d3-a456-426614174000",
        "children": [
          {
            "folderId": "123e4567-e89b-12d3-a456-426614174000",
            "name": "text",
            "parentFolderId": "123e4567-e89b-12d3-a456-426614174000",
            "children": "[Circular Reference]",
            "items": [
              {
                "tenantAssetId": "text",
                "tenantId": "text",
                "assetId": "text",
                "assetType": "text",
                "createdDate": "2026-02-23T10:08:29.236Z",
                "isEffectiveIdentityRolesRequired": true,
                "assetName": "text",
                "embedUrl": "text",
                "webUrl": "text",
                "datasetId": "text",
                "reportType": "text",
                "isEffectiveIdentityRequired": true,
                "modifiedOn": "2026-02-23T10:08:29.236Z",
                "rolesSupported": "text",
                "reportPages": [
                  {
                    "ANY_ADDITIONAL_PROPERTY": "anything"
                  }
                ],
                "isRefreshable": true,
                "folderId": "text",
                "description": "text",
                "canView": true,
                "canCreate": true,
                "canEdit": true,
                "canExport": true,
                "createdBy": "text",
                "modifiedBy": "text",
                "fullPath": "text",
                "isReportTemplate": true,
                "reportParameter": [
                  {
                    "columnName": "text",
                    "columnLabel": "text"
                  }
                ]
              }
            ]
          }
        ],
        "items": [
          {
            "tenantAssetId": "text",
            "tenantId": "text",
            "assetId": "text",
            "assetType": "text",
            "createdDate": "2026-02-23T10:08:29.236Z",
            "isEffectiveIdentityRolesRequired": true,
            "assetName": "text",
            "embedUrl": "text",
            "webUrl": "text",
            "datasetId": "text",
            "reportType": "text",
            "isEffectiveIdentityRequired": true,
            "modifiedOn": "2026-02-23T10:08:29.236Z",
            "rolesSupported": "text",
            "reportPages": [
              {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              }
            ],
            "isRefreshable": true,
            "folderId": "text",
            "description": "text",
            "canView": true,
            "canCreate": true,
            "canEdit": true,
            "canExport": true,
            "createdBy": "text",
            "modifiedBy": "text",
            "fullPath": "text",
            "isReportTemplate": true,
            "reportParameter": [
              {
                "columnName": "text",
                "columnLabel": "text"
              }
            ]
          }
        ]
      }
    ],
    "items": [
      {
        "tenantAssetId": "text",
        "tenantId": "text",
        "assetId": "text",
        "assetType": "text",
        "createdDate": "2026-02-23T10:08:29.236Z",
        "isEffectiveIdentityRolesRequired": true,
        "assetName": "text",
        "embedUrl": "text",
        "webUrl": "text",
        "datasetId": "text",
        "reportType": "text",
        "isEffectiveIdentityRequired": true,
        "modifiedOn": "2026-02-23T10:08:29.236Z",
        "rolesSupported": "text",
        "reportPages": [
          {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "isRefreshable": true,
        "folderId": "text",
        "description": "text",
        "canView": true,
        "canCreate": true,
        "canEdit": true,
        "canExport": true,
        "createdBy": "text",
        "modifiedBy": "text",
        "fullPath": "text",
        "isReportTemplate": true,
        "reportParameter": [
          {
            "columnName": "text",
            "columnLabel": "text"
          }
        ]
      }
    ]
  }
]