---
title: "PUT /stac/collections/{collectionId}/items/{itemId}"
method: PUT
path: "/stac/collections/{collectionId}/items/{itemId}"
tags: ["SpatioTemporal Asset Catalog (STAC) API"]
---

# PUT /stac/collections/{collectionId}/items/{itemId}

`PUT /stac/collections/{collectionId}/items/{itemId}`

Replace a STAC item in a collection

## Path parameters

- `collectionId` string, required
- `itemId` string, required

## Query parameters

- `api-version` string, required

## Request body

- StacItem — Base type for STAC items and collections with discriminator.
  - `type` string, required — Discriminator property for StacItemOrStacItemCollection.
  - `stac_version` string — Stac Version
  - `links` StacLink[] — 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.
  - `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.

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

- Operation — Microsoft Planetary Computer Pro geo-catalog operation
  - `id` string, uuid, required — Universally Unique Identifier
  - `status` 'Pending' | 'Running' | 'Succeeded' | 'Canceled' | 'Canceling' | 'Failed', required — Operation status
  - `type` string, required — Operation type
  - `creationTime` string, date-time, required — The UTC time at which the operation was created
  - `collectionId` string — Collection ID
  - `statusHistory` OperationStatusHistoryItem[], required — The history of the operation status in time
    - `timestamp` string, date-time, required — The UTC time at which the status was set
    - `status` 'Pending' | 'Running' | 'Succeeded' | 'Canceled' | 'Canceling' | 'Failed', required — Operation status
    - `errorCode` string — If the status is failed, the error code
    - `errorMessage` string — If the status is failed, the error message
  - `startTime` string, date-time — The UTC time at which the operation was started
  - `finishTime` string, date-time — The UTC time at which the operation finished its execution
  - `additionalInformation` object — Additional information elements about the particular operation type
  - `error` ErrorInfo — Error information wrapper
    - `error` AzureCoreFoundationsError, required — The error object.
      - `code` string, required — One of a server-defined set of error codes.
      - `message` string, required — A human-readable representation of the error.
      - `target` string — The target of the error.
      - `details` AzureCoreFoundationsError[] — An array of details about specific errors that led to this reported error.
      - `innererror` AzureCoreFoundationsInnerError — An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
        - `code` string — One of a server-defined set of error codes.
        - `innererror` AzureCoreFoundationsInnerError — recursive

## 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/revisions/42447be18bc5/schema)