List Assets

GET/v1/assets

List assets for the current user.

Authentication

Authorization Bearer — JWT session or sk-* API key.

Query Parameters

currentinteger

Page number. Defaults to 1.

sizeinteger

Page size. Defaults to 20. Maximum is 100.

keywordstring

Filter by asset name or asset ID.

assetKindstring

Filter by asset kind: USER_UPLOAD, AI_GENERATED, REAL_FACE, or VIRTUAL_PORTRAIT.

sourceTypestring

Filter by source: UPLOAD, AI_GENERATION, or ASSET_LIFECYCLE.

mediaTypestring

Filter by media type: IMAGE, VIDEO, AUDIO, or OTHER.

statusstring

Filter by status.

createdBystring

Filter by creator name, username, or email within the current accessible scope.

usedModelstring

Filter by model used to generate the asset.

createdFromstring

Filter by created-at start time (ISO-8601).

createdTostring

Filter by created-at end time (ISO-8601).

groupIdstring

Filter by asset group ID.

Response

codeinteger

Response status code.

dataobject

Paginated asset list response.

data.paginationobject

Pagination metadata.

data.listarray

Asset records.

msgstring

Response message.

serviceCodestring | null

Service error code on failure.

Request

Shell

1curl "https://api.token360.ai/v1/assets?current=1&size=20" \
2  -H "Authorization: Bearer sk-your-api-key"

Response

JSON

1{
2  "code": 200,
3  "data": {
4    "pagination": {
5      "currentPage": "1",
6      "total": "1",
7      "totalPage": "1",
8      "pageSize": "20"
9    },
10    "list": [
11      {
12        "assetId": "ua_1234567890abcdef",
13        "name": "avatar.png",
14        "assetKind": "USER_UPLOAD",
15        "mediaType": "IMAGE"
16      }
17    ]
18  },
19  "msg": "success"
20}

Managed asset quota and lifecycle

Virtual Portrait and Real Face uploads share the managed-asset quota for the current personal or tenant scope. Treat Get Asset Quota as the source of truth. The current default is 50,000 for a personal scope and 500,000 for a tenant scope; configured limits may differ.

Use only the public assetId and assetGroupId returned by Token360 in client integrations.

Was this page helpful?