Skip to content

List Assets

List the assets in your account, with optional filtering, sorting, and pagination.

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

Query Parameters

groupId string
Normal: ignored (your account's group is always used). VIP: optional, defaults to your account's group.
page integer Default: 1
1-indexed page number.
pageSize integer Default: 20
Items per page. Maximum 100.
sortBy string Default: createTime
Sort field. One of createTime, updateTime, groupId.
sortOrder string Default: desc
Sort direction. One of desc, asc.
status string
Filter by status. One of processing, active, failed.
assetType string
Filter by type. One of image, video, audio.
name string
Filter by asset name. 
# List your assets (no parameters needed)
curl https://console-api.siraya.ai/extapi/v1/assets \
  -H "Authorization: Bearer <API_KEY>"

# With filters (VIP can also scope by groupId)
curl "https://console-api.siraya.ai/extapi/v1/assets?page=1&pageSize=20&sortBy=createTime&sortOrder=desc&status=active" \
  -H "Authorization: Bearer <API_KEY>"

import requests

url = "https://console-api.siraya.ai/extapi/v1/assets"
headers = {"Authorization": "Bearer <API_KEY>"}
params = {"pageSize": 50, "status": "active"}

response = requests.get(url, headers=headers, params=params)
items = response.json()["data"]["items"]
print(items)

Example Response

{
  "isSuccess": true,
  "data": {
    "items": [
      {
        "assetId": "a-9z8y7x",
        "assetUri": "asset://a-9z8y7x",
        "groupId": "g-1a2b3c",
        "type": "image",
        "name": "hero.png",
        "status": "active",
        "url": "https://.../signed",
        "createdAt": "2026-06-10T12:00:00Z",
        "updatedAt": "2026-06-10T12:01:00Z"
      }
    ]
  },
  "pagination": { "page": 1, "pageSize": 20, "total": 137, "totalPages": 7 }
}