All Products
Search
Document Center

DataWorks:ListMetaCollections

Last Updated:Jan 12, 2026

Queries a list of collections in Data Map. Collections include categories and data albums.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
TypestringYes

The collection type. Valid values:

  • Category
  • Album
  • AlbumCategory: Album subcategory
Category
ParentIdstringNo

The ID of the parent collection.

category.123
NamestringNo

The collection name. Supports fuzzy matching.

test
DescriptionstringNo

The collection description. Supports fuzzy matching.

CreateUserstringNo

The creator user ID. Valid only for album types. Default: The current user ID.

123456
AdministratorstringNo

The administrator ID. Valid only for album types. Default: The current user ID.

12345
SortBystringNo

The sort field. Valid values:

  • Id (default)
  • Name
  • CreateUser: Creator ID
  • CreateTime: Creation time
  • ModifyTime: Modification time
Name
OrderstringNo

The sort order. Valid values:

  • Asc (default): Ascending order
  • Desc
Asc
PageNumberintegerNo

The page number. Default: 1.

1
PageSizeintegerNo

The number of entries per page. Default: 10. Maximum: 100.

10

Response parameters

ParameterTypeDescriptionExample
object

The response.

RequestIdstring

The request ID.

E25887B7-579C-54A5-9C4F-83A0DE367DDE
Dataobject

Pagination information.

TotalCountinteger

The total number of records.

10
PageNumberinteger

The page number.

1
PageSizeinteger

The number of entries per page.

10
MetaCollectionsarray<object>

The list of collections.

metaCollectionsobject

The collection.

Namestring

The collection name.

test_category
Idstring

The collection name.

category.123
ParentIdstring

The ID of the parent collection. Can be empty.

category.1
Descriptionstring

The collection description.

Typestring

The collection type. Valid values:

  • Category
  • Album
  • AlbumCategory: Album subcategory
Category
CreateUserstring

The creator user ID.

456789
CreateTimestring

The creation time in milliseconds (timestamp).

1668568601000
ModifyTimestring

The modification time in milliseconds (timestamp).

1668568601000
Administratorsarray

The list of administrator IDs. Supported only for album types. Administrators must be users within the same tenant. Multiple administrators can be specified.

administratorsstring

The administrator ID.

765432

Examples

Sample success responses

JSONformat

{
  "RequestId": "E25887B7-579C-54A5-9C4F-83A0DE367DDE",
  "Data": {
    "TotalCount": 10,
    "PageNumber": 1,
    "PageSize": 10,
    "MetaCollections": [
      {
        "Name": "test_category",
        "Id": "category.123\n\n",
        "ParentId": "category.1",
        "Description": "",
        "Type": "Category",
        "CreateUser": 456789,
        "CreateTime": 1668568601000,
        "ModifyTime": 1668568601000,
        "Administrators": [
          765432
        ]
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.