Token360
Log InSign Up

Create Asset Group

POST/v1/asset-groups

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 — JWT session or sk-* API key.

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.

defaultUploadTtlDaysinteger

Optional default TTL in days for USER_UPLOAD assets in GENERIC groups (1–3650).

Response

codeinteger

Response status code.

dataobject

Created asset group.

data.assetGroupIdstring

Group public ID.

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.verificationStatusstring

Real Face verification status, when applicable.

data.activationAllowedboolean

Whether the group currently satisfies activation requirements.

data.activationBlockedReasonstring

Reason activation is blocked, when applicable.

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.

Request

Shell
1curl -X POST https://api.token360.ai/v1/asset-groups \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{"name":"Marketing Assets","groupKind":"GENERIC"}'

Response

JSON
1{
2  "code": 200,
3  "data": {
4    "assetGroupId": "your-asset-group-id",
5    "name": "Marketing Assets",
6    "groupKind": "GENERIC"
7  },
8  "msg": "success"
9}
Was this page helpful?
Create Asset Group · Token360