v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

List Asset Groups

Query asset groups with optional filters. This is a read-only operation and is not billed.

post/volc/asset/ListAssetGroups

Request body

modelstring required

Model name. Default: volc-asset.

PageNumberinteger

Page number. Default: 1.

PageSizeinteger

Items per page. Default: 10.

Example request

{
  "model": "volc-asset",
  "Filter": {
    "Name": "my-project",
    "GroupType": "LivenessFace",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ]
  },
  "PageNumber": 1,
  "PageSize": 10
}

Response

Asset groups retrieved

PageNumberinteger

PageSizeinteger

TotalCountinteger

Example response

{
  "Items": [
    {
      "Id": "group-20260320141746-zsf6b",
      "Name": "test-token",
      "Title": "[u-1]-[t-88] test-token",
      "GroupType": "LivenessFace",
      "ProjectName": "default",
      "CreateTime": "2026-03-20T14:17:46Z",
      "UpdateTime": "2026-03-20T14:17:46Z"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 2
}