GRGlobalRouter Docs
Console

Assets / POST

Import asset

Import assets from an application URL.

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.
POST/api/v1/assets

A successful import returns an asset_id that can be referenced in later tasks.

Back to Assets endpoint list

Request parameters

FieldTypeRequiredDescription
providerstringNoAsset provider; defaults to mtkw.
group_idstringYesAsset group ID.
source_urlstringYesAccessible asset URL.
asset_typestringYesAsset type: image, video, or audio.
namestringYesAsset name, 1 to 32 characters.

Response fields

FieldTypeRequiredDescription
idstringYesAsset ID.