List Groups

List the asset groups in your account.

VIP only. This endpoint is available to VIP accounts only. Normal accounts get 403 TIER_FORBIDDEN — their single group is used automatically and needs no management.

GET https://console-api.siraya.ai/extapi/v1/assets/groups

Query Parameters

page integer Default: 1

1-indexed page number.

pageSize integer Default: 20

Items per page.

name string

Fuzzy filter by group name.

cURLPython

curl "https://console-api.siraya.ai/extapi/v1/assets/groups?pageSize=20" \
  -H "Authorization: Bearer <API_KEY>"

import requests

url = "https://console-api.siraya.ai/extapi/v1/assets/groups"
headers = {"Authorization": "Bearer <API_KEY>"}

response = requests.get(url, headers=headers, params={"pageSize": 20})
print(response.json()["data"]["items"])

Example Response

{
  "isSuccess": true,
  "data": {
    "items": [
      {
        "groupId": "g-1a2b3c",
        "name": "Marketing images",
        "description": "",
        "isDefault": false,
        "createdAt": "2026-06-01T08:00:00Z"
      }
    ]
  },
  "pagination": { "page": 1, "pageSize": 20, "total": 3, "totalPages": 1 }
}