SpatioTemporal Asset Catalog (STAC) API

Changed on

Replace a STAC item in a collection

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

Request

  • Base URL
    {endpoint}
  • URL
    {endpoint}/stac/collections/{collectionId}/items/{itemId}
  • Auth
    OAuth 2
    Implicit: https://login.microsoftonline.com/common/oauth2/authorize
    Scopes: https://geocatalog.spatio.azure.com/.default

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

  • 2025-04-30-preview42447be18bc5Revision changes
    • info

      api operation id StacItems_CreateOrReplace removed and replaced with StacItems_Replace

  • 2025-04-30-preview00cbc3d6d8e0Revision changes
    • info

      api operation id StacItems_Replace removed and replaced with StacItems_CreateOrReplace