Skip to content

Create a Group

Create a new asset group. Returns the created group with 201 Created.

VIP only. This endpoint is available to VIP accounts only. Normal accounts get 403 TIER_FORBIDDEN.

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

Body

name string Required
The group name.
description string
An optional description of the group. 
curl -X POST https://console-api.siraya.ai/extapi/v1/assets/groups \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Marketing images","description":"Q3 campaign"}'

import requests

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

response = requests.post(
    url,
    headers=headers,
    json={"name": "Marketing images", "description": "Q3 campaign"},
)
print(response.json()["data"])

Example Response

{
  "isSuccess": true,
  "data": {
    "groupId": "g-1a2b3c",
    "name": "Marketing images",
    "description": "Q3 campaign",
    "isDefault": false,
    "createdAt": "2026-06-11T10:30:00Z"
  }
}