GRGlobalRouter Docs
Console

Assets / GET

List assets

Lists assets by provider, group, or status.

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
POST/api/v1/assets/groupsCreates an asset group.
GET/api/v1/assets/groupsLists asset groups visible to the current tenant.
GET/api/v1/assets/groups/{group_id}Reads details for one asset group.
PATCH/api/v1/assets/groups/{group_id}Updates an asset group's name or description.
DELETE/api/v1/assets/groups/{group_id}Deletes an asset group.
POST/api/v1/assetsImport assets from an application URL.
GET/api/v1/assetsLists assets by provider, group, or status.
GET/api/v1/assets/{asset_id}Reads one asset's import status and reference information.
PATCH/api/v1/assets/{asset_id}Updates an asset name.
DELETE/api/v1/assets/{asset_id}Deletes an asset.
POST/api/v1/assets/{asset_id}/refreshRefreshes asset status or metadata.
GET/api/v1/assets

Useful for asset management pages, task input pickers, and status synchronization.

Back to Assets endpoint list

Request parameters

FieldTypeRequiredDescription
providerstringNoFilter by provider.
group_idstringNoFilter by asset group.
statusstringNoFilter by asset status.
pageintegerNoPage number, minimum 1.
page_sizeintegerNoItems per page, from 1 to 100.

Response fields

FieldTypeRequiredDescription
dataobject[]YesAsset list.
data[].idstringYesAsset ID.
data[].upload_namestringNo上传名称。
data[].descriptionstringNo资产说明。
data[].urlstringNoassets URL。
data[].namestringNo资产名称。
data[].asset_typestringNoAsset type.
data[].group_idstringNoAsset group ID.
data[].project_namestringNo项目名称。
data[].provider_idstringNoProvider ID。
items[].providerstringNoassets Provider。
items[].group_idstringNoAsset group ID.
items[].provider_group_idstringNo上游assets服务分组 ID。
items[].provider_statusstringNoStatus summary returned by the provider.
items[].status_error_codestringNo失败时的 Provider 错误码。
next_cursorstringNo下一页游标。
data[].statusstringYesprocessing, active, failed, or unknown.
data[].provider_statusstringNoStatus summary returned by the provider.
data[].status_error_codestringNo失败时的 Provider 错误码。
data[].status_error_messagestringNo失败时的 Provider 错误信息。
data[].status_synced_atstringNo状态同步时间。
total_countintegerYesTotal assets matching the filters.
page_numberintegerYesCurrent page number.
page_sizeintegerYesItems per page.