Skip to content
Ads APIReferences / assets / Update Asset

Update Asset

Updates the given existing asset.

Request

  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • asset_id
    string [uuid]
    Required

    A unique identifier for the entity.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"

Update the name on the given asset. The asset_type field is solely used as a filter and is not an updatable field.

  • asset_type
    string

    The type of asset.

    Example value: "IMAGE"Allowed values: "AUDIO", "IMAGE", "VIDEO"
  • name
    string
    Required

    The new name of the asset file.

    Example value: "logoImage.png"Length between 2 and 120

Response

The newly updated asset metadata.

Will be one of the following:
  • Metadata object for an image asset type.

  • Metadata object for an audio asset type.

  • Metadata object for a video asset type.

Response sample

{  "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",  "name": "logoImage.png",  "assetType": "IMAGE",  "status": "READY",  "url": "https://i.scdn.co/image/123",  "created_at": "2026-01-23T04:56:07Z",  "updated_at": "2026-01-23T04:56:07Z",  "image_type": "COMPANION",  "file_type": "JPEG"}