Retrieve the asset details

Request

Retrieves the details of a specific digital asset by specifying its ID.

Security

HTTPBearer

Path

assetIdstring, (uuid)(Assetid)required

The unique identifier of the asset to be retrieved.

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

x-sc-job-idany(X-Sc-Job-Id)

A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.

Example:job-1234

curl -i -X GET \
  https://edge-platform.sitecorecloud.io/stream/ai-agent-api/api/v1/assets/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'x-sc-job-id: job-1234'

Responses

Successful response

Bodyapplication/json

idstring, (uuid)(Id)

The unique identifier of the asset.

Example:"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

namestring or null(Name)

Example:"Sample Image"

Any of:

The name of the asset.

string

typestring or null(Type)

Example:"image"

Any of:

The type of asset, for example, image or document.

string

urlstring or null(Url)

Example:"https://example.com/assets/a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Any of:

The URL where the asset can be accessed.

string

sizeinteger or null(Size)

Example:204800

Any of:

The size of the asset in bytes.

integer

metadataAssetInformationMetadata (object) or null

Any of:

Additional metadata about the asset.

innerItemInnerItemModel (object) or null

Any of:

Details about the inner item if the asset is a container item.

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Sample Image",
  "type": "image",
  "url": "https://example.com/assets/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "size": 204800,
  "metadata": {
    "width": 1920,
    "height": 1080,
    "format": "jpg",
    "alt_text": "A beautiful sunset over the mountains."
  },
  "innerItem": {
    "displayName": "Promo Image",
    "height": 250,
    "width": 300
  }
}