List asset groups
List asset groups for the current user with pagination and name filtering.
Third-party SaaS callers should pass external_user_id to scope results to a specific end-user; omitting it returns only groups bound to the API key holder directly (legacy / first-party behaviour).
Authorization
BearerAuth API key authentication (OpenAI format). Pass in the Authorization header:
Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
In: header
Query Parameters
Page number, starting from 1
11 <= valueItems per page, maximum 100
101 <= value <= 100Filter by group name (fuzzy match)
Group type filter. aigc (default) returns AIGC asset groups; real_person returns LivenessFace groups created via validate-session. Upstream Ark requires exactly one type — there is no "return both" option, so you must call this endpoint twice if you need both lists.
"aigc""aigc" | "real_person"Optional third-party SaaS end-user identifier. When set, only groups bound to (api_user, external_user_id) are returned. Omit (or leave empty) to return groups bound directly to the API key holder (legacy behaviour). Max 128 chars.
length <= 128Response Body
application/json
application/json
application/json
curl -X get "https://api.xrtoken.ai/v1/asset-groups?external_user_id=end-user-42"{
"Items": [
{
"Id": "string",
"Name": "string",
"Description": "string",
"GroupType": "AIGC",
"CreateTime": "string",
"UpdateTime": "string"
}
],
"TotalCount": 0,
"PageNumber": 0,
"PageSize": 0
}{
"error": "invalid or missing API key",
"type": "auth_error"
}{
"error": "rate limit exceeded",
"type": "rate_limit_error"
}