SpatioTemporal Asset Catalog (STAC) API

Replace a STAC item in a collection

put/stac/collections/{collectionId}/items/{itemId}

Path parameters

collectionIdstring required

Catalog collection id

itemIdstring required

STAC Item id

Query parameters

api-versionstring required

The API version to use for this operation.

Request body

typestring required

Discriminator property for StacItemOrStacItemCollection.

stac_versionstring

Stac Version

msft:_createdstring date-time

MSFT Created

msft:_updatedstring date-time

MSFT Updated

msft:short_descriptionstring

MSFT Short Description

stac_extensionsstring[]

URLs to STAC extensions implemented by this STAC resource.

Response

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

idstring uuid required

Universally Unique Identifier

status'Pending' | 'Running' | 'Succeeded' | 'Canceled' | 'Canceling' | 'Failed' required

Operation status

typestring required

Operation type

creationTimestring date-time required

The UTC time at which the operation was created

collectionIdstring

Collection ID

startTimestring date-time

The UTC time at which the operation was started

finishTimestring date-time

The UTC time at which the operation finished its execution

additionalInformationobject

Additional information elements about the particular operation type

Changes

Changed in 2 of the 8 revisions of this API.2

  • 2025-04-30-preview42447be18bc51See the full diff
    • api operation id StacItems_CreateOrReplace removed and replaced with StacItems_Replace

      api-operation-id-removed

  • 2025-04-30-preview00cbc3d6d8e01See the full diff
    • api operation id StacItems_Replace removed and replaced with StacItems_CreateOrReplace

      api-operation-id-removed