---
title: Assets Endpoints
framework: Apple Ads Platform API
role: collectionGroup
role_heading: API Collection
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/assets-endpoints
---

# Assets Endpoints

Upload, query, retrieve, and delete Apple Maps creative assets.

## Overview

Overview You use assets to build creative for your campaigns. Uploading new assets through this API is available only for Apple Maps brands, but querying and retrieving assets covers both App Store apps and Apple Maps brands. Each asset carries metadata about its type, dimensions, eligibility status, and any rejection reasons. Use the Endpoints The Assets API provides four endpoints for uploading, querying, retrieving, and deleting assets:  |  |   |  |   |  |   |  |   |  |  Identify the Asset Type Every asset has an assetType field, which identifies the kind of media it contains. Currently, IMAGE is the only supported value, and it represents a static image file. See ImageType for the full list of supported formats. Upload Assets Assets enter the system through a single upload method. Send a multipart form to POST /v1/assets/upload (Upload Asset) containing the binary image file (file), promotedObjectId, and promotedObjectType: BUSINESS_BRAND. The endpoint accepts PNG, JPG, and HEIC formats. This endpoint only supports asset uploads for Apple Maps (BUSINESS_BRAND) assets, and it doesn’t accept any other value for promotedObjectType. The uploaded asset belongs to the ad account identified by the X-AP-Context header and becomes part of that account’s asset library. After upload, the asset begins processing. Poll using Get Asset until the eligibility.status indicates the asset is ready before referencing it in a creative. Query Assets To find assets, use POST /v1/assets/query (Query Assets) with the following filterable fields:  |  |   |  |   |  |   |  |   |  |  Review the Shared Response Fields Every asset response includes the following fields:  |   |   |   |   |   |   |   |   |   |   |   |   |   |  Delete Assets You can only delete assets you’ve uploaded. A call to Get Asset still returns a deleted asset and marks it with deleted: true, but Query Assets excludes deleted assets from results by default.

## Topics

- [Upload Asset](apple-ads-platform-api/upload-asset.md)
- [Query Assets](apple-ads-platform-api/query-assets.md)
- [Get Asset](apple-ads-platform-api/get-asset-by-id.md)
- [Delete Asset](apple-ads-platform-api/delete-asset-by-id.md)

## See Also

### Assets

- [Assets Data Objects](apple-ads-platform-api/assets-data-objects.md)
- [Assets Data Types](apple-ads-platform-api/assets-data-types.md)