Folders

Get Paginated List of Children of a Folder

Changed on

This endpoint retrieves a paginated list of top-level assets (folders, files, or other resources) contained within a specified folder, identified by its assetId. This allows clients to explore the immediate children of the folder, supporting use cases like folder browsing and navigation.

The response includes all assets that the requester is authorized to view — regardless of asset type — excluding any that are hidden or discarded. Each item in the list contains basic metadata about the asset such as name, type, path, and identifiers.

NOTE:

  • The response supports cursor-based pagination and includes a nextUrl field when additional pages are available.
  • If there are no further results, the nextUrl field is omitted.
  • The requester must have at least read-level access to the folder.
  • Assets are returned with basic metadata such as name, type, and hierarchy position.
get/folders/{assetId}/children

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/folders/{assetId}/children
  • Auth: HTTP bearer

Path parameters

assetIdstring required

A globally unique identifier for the asset

Example:urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174

The ID of the asset to get.

Query parameters

limitinteger
  • Provides a hint for the number of items per page.
  • In cases where multiple elements have the same field value used to split the page, the server may adjust the number of items returned to ensure page boundaries align correctly.
cursorstring

Cursor used for fetching next set of results.

  • If not provided, the first page of results is returned.
  • For subsequent pages, only the cursor should be sent.

NOTE:
The cursor is opaque and should not be parsed or modified by clients.

sortBystring

Defines the sort order.

  • If not specified, the default is +name.
  • Prefix with - for descending order. + is optional for ascending order.

Following fields are supported for sorting:

  • name
  • created
  • modified

NOTE:

  • Only applicable for the first page. Subsequent pages must use the cursor.
filterstring

FIQL-based filter string

Following fields are supported for filtering:

  • mediaType: Filter by media type (operators allowed are == and =in=). Multiple values are supported.
  • assetType: Filter by asset type (operators allowed are ==). Single value is only supported.
  • state: Filter by asset state (operators allowed are ==). Single value is only supported.
    • active (default): Filter by active assets.
    • deleted: Filter by (soft)deleted assets.

NOTE:

  • Only applicable for the first page. Subsequent pages must use the cursor.

Headers

x-request-idstring
Example:1234567890

The X-Request-Id header is used to identify a request.
It can be used to correlate logs and other resources and is intended to be a non-persistent identifier.

Response

Success - Paginated response containing an array of object with each element containing basic information about the project, along with paging information.

Example response

{
  "paging": {
    "limit": 10,
    "nextUrl": "https://api.example.com/assets?cursor=550e8400-e29b-41d4-a716-446655440000&limit=10"
  },
  "children": [
    {
      "assetId": "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
      "name": "My Asset",
      "createdDate": "2021-01-01T00:00:00Z",
      "modifiedDate": "2021-01-01T00:00:00Z",
      "createdBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
      "modifiedBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
      "path": "/My Project/My Folder/My Asset",
      "ancestors": [
        "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
        "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a175",
        "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a176"
      ],
      "mediaType": "image/jpeg",
      "size": 1048576
    }
  ]
}

Changes

  • db8282e0f96aRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • info

      added brand discriminator mapping keys to the / response property for the response status

  • 240b6278279cRevision changes
    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status