Get Asset Group

GET/v1/asset-groups/{groupId}

Get an asset group.

Authentication

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

Path Parameters

groupIdstringrequired

Asset group ID.

Response

codeinteger

Response status code.

dataobject

Asset group details.

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 for USER_UPLOAD assets, if configured.

data.createdAtstring

Create timestamp.

data.updatedAtstring

Update timestamp.

msgstring

Response message.

serviceCodestring | null

Service error code on failure.

Request

Shell

1curl https://api.token360.ai/v1/asset-groups/{groupId} \
2  -H "Authorization: Bearer sk-your-api-key"

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}

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?