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

# Create Collection Asset

`POST /stac/collections/{collectionId}/assets`

Create a new asset in the Collection metadata and write the associated
file to managed storage.

## Path parameters

- `collectionId` string, required

## Query parameters

- `api-version` string, required

## Response `201`

The request has succeeded and a new resource has been created as a result.

- 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.

---

[API](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/versions/42447be18bc5/schema)