List Asset Groups

GET /api/volc-user/asset-groups

Retrieve a paginated list of the current user's asset groups, with support for filtering by group type, name, and sorting.

Authentication

User console API requiring logged-in user identity (session Cookie, or Authorization: <access_token>, token obtained via Generate Access Token). This token is different from the sk- keys used for model invocation.

Query Parameters

Name	Type	Required	Description
pageNumber	integer	Optional	Page number, starting from 1, default 1
pageSize	integer	Optional	Items per page, default 20, max 100
groupIds	string[]	Optional	Asset group ID list, supports repeated params or comma-separated
groupType	string	Required	Asset group type, e.g. AIGC
projectName	string	Optional	Volcengine project name
name	string	Optional	Fuzzy search by name or ID
sortBy	string	Optional	Sort field: Id, CreateTime, UpdateTime, Name, GroupType
sortOrder	string	Optional	Sort order: Asc ascending, others descending

Request Example

GET /api/volc-user/asset-groups?pageNumber=1&pageSize=20&groupType=AIGC&name=product&sortBy=CreateTime&sortOrder=Desc

Response Fields (200)

Name	Type	Description
success	boolean	Success flag
message	string	Message
data	object	Pagination object
data.totalCount	integer	Total count
data.pageNumber	integer	Current page number
data.pageSize	integer	Items per page
data.items	array<object>	Asset group list
data.items[].id	string	Asset group ID
data.items[].name	string	Asset group name
data.items[].description	string	Asset group description
data.items[].groupType	string	Asset group type
data.items[].projectName	string	Volcengine project name
data.items[].createTime	integer	Create time (Unix seconds)
data.items[].updateTime	integer	Update time (Unix seconds)
data.items[].remark	string	Platform remark, typically same as description

Response Example

{
  "success": true,
  "message": "",
  "data": {
    "totalCount": 2,
    "pageNumber": 1,
    "pageSize": 20,
    "items": [
      {
        "id": "group-7f2b8d9c",
        "name": "Product Model Asset Group",
        "description": "Images and videos for product short video generation",
        "groupType": "AIGC",
        "projectName": "default_project",
        "createTime": 1718000000,
        "updateTime": 1718000000,
        "remark": "Images and videos for product short video generation"
      }
    ]
  }
}