Create Asset Group

Create an asset group for organizing Token360 assets.

Use groupKind to choose the group type:

GENERIC for regular uploaded or generated assets.
REAL_FACE for RealFace assets. The response may include an h5Link verification URL.
VIRTUAL_PORTRAIT for Virtual Portrait assets.

Authentication

Authorization Bearer

API key as bearer token in Authorization header.

Request Body

namestring

Optional group display name.

groupKindstring

Optional group kind: GENERIC, REAL_FACE, or VIRTUAL_PORTRAIT. Defaults to GENERIC.

emailstring

Optional RealFace contact email.

phonestring

Optional contact phone for REAL_FACE groups.

descriptionstring

Optional group description.

defaultUploadTtlDaysinteger

Optional default TTL in days for USER_UPLOAD assets in GENERIC / GENERATED groups.

Response

codeinteger

Response status code.

dataobject

Created group record (`UnifiedAssetGroupVO`).

data.idinteger

Internal group ID.

data.assetGroupIdstring

Group public ID.

data.tenantIdinteger

Tenant ID.

data.userIdinteger

Owner user ID.

data.userNamestring

Owner display name.

data.sharedboolean

Whether the group is shared with the caller.

data.sharePermissionstring

Share permission when shared.

data.shareExpiresAtstring

Share expiry time when shared.

data.namestring

Group name.

data.groupKindstring

Group kind.

data.statusstring

Group status.

data.assetCountinteger

Number of assets in the group.

data.h5Linkstring

Verification link for REAL_FACE groups when pending.

data.defaultUploadTtlDaysinteger

Default upload TTL in days when the group is configured for upload overrides.

data.createdAtstring

Create timestamp.

data.updatedAtstring

Update timestamp.

msgstring

Response message.

serviceCodestring | null

Service error code on failure.