---
title: "Delete Collection Asset"
method: DELETE
path: "/stac/collections/{collectionId}/assets/{assetId}"
tags: ["STAC Collection Configuration"]
---

# Delete Collection Asset

`DELETE /stac/collections/{collectionId}/assets/{assetId}`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/stac/collections/{collectionId}/assets/{assetId}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `https://geocatalog.spatio.azure.com/.default`

Delete an asset from a given collection.

## Path parameters

- `collectionId` string, required
- `assetId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- StacCollection: https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md Represents a STAC collection.
  - `msft:_created` string, date-time: MSFT Created
  - `msft:_updated` string, date-time: MSFT Updated
  - `msft:short_description` string: MSFT Short Description
  - `stac_extensions` string[]: URLs to STAC extensions implemented by this STAC resource.
  - `id` string, required: Unique identifier for the collection.
  - `description` string, required: Detailed description of the collection.
  - `stac_version` string: Stac Version
  - `links` StacLink[], required: Links to related resources and endpoints.
    - `rel` string: The relationship type of the link.
    - `title` string: The title of the link.
    - `type` 'image/tiff; application=geotiff' | 'image/jp2' | 'image/png' | 'image/jpeg' | 'image/jpg' | 'image/webp' | 'application/x-binary' | 'application/xml' | 'application/json' | 'application/geo+json' | 'text/html' | 'text/plain' | 'application/x-protobuf': The MIME type of the linked resource.
    - `href` string, required: The URL of the link.
    - `hreflang` string: The language of the linked resource.
    - `length` integer: The length of the linked resource.
    - `method` 'GET' | 'POST': Specifies the HTTP method that the resource expects. Default: GET.
    - `headers` object: Object key-value pairs that map to headers. Example: { "Accept": "application/json" }.
    - `body` object: For POST requests, the resource can specify the HTTP body as a JSON object.
    - `merge` boolean: Indicates whether the client is expected to merge the body value into the current request body before following the link. This is only valid when the server is responding to a POST request. Default: false.
  - `title` string: Human-readable title for the collection.
  - `type` string: Type
  - `assets` object: Assets
  - `item_assets` object: Item Assets See the [Item Assets Definition Extension Specification](https://github.com/stac-extensions/item-assets)
  - `license` string, required: License identifier for the collection data.
  - `extent` StacExtensionExtent, required: https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#extent-object Represents the spatial and temporal extent of a STAC collection.
    - `spatial` StacExtensionSpatialExtent, required: https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#spatial-extent-object Represents the spatial extent of a STAC collection with bounding boxes.
      - `bbox` array[]: Array of bounding boxes defining the spatial extent, in format [[west, south, east, north]].
        - number[]
    - `temporal` StacCollectionTemporalExtent, required: https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#temporal-extent-object Represents the temporal extent of a STAC collection with time intervals.
      - `interval` array[], required: Array of time intervals in format [[start_datetime, end_datetime]].
        - string[]
  - `keywords` string[]: Keywords describing the collection.
  - `providers` StacProvider[]: Organizations or individuals who provide the collection data.
    - `name` string, required: Name of the provider organization or individual.
    - `description` string: Description of the provider.
    - `roles` string[]: Roles played by the provider (e.g., producer, processor, host).
    - `url` string: URL to the provider's website.
  - `summaries` object: Summaries See the [STAC Collection Spec](https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#spatial-extent-object).

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-02-19** (2025-04-30-preview) `28e8cb365289`: 1 breaking
  - removed the success response with the status `204`
- **2025-05-15** (2025-04-30-preview) `00cbc3d6d8e0`: 1 info
  - added the success response with the status `204`

[Operation history](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/changes/stac/collections/:collectionId/assets/:assetId/delete.md)

---

[API](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer.md) - [All operations](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/revisions/42447be18bc5?raw)