SpatioTemporal Asset Catalog (STAC) API

Create Collection

Changed on

Create a new collection in the GeoCatalog instance

post/stac/collections

Request

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

Query parameters

api-versionstring required

The API version to use for this operation.

Request body

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.

idstring required

Unique identifier for the collection.

descriptionstring required

Detailed description of the collection.

stac_versionstring

Stac Version

titlestring

Human-readable title for the collection.

typestring

Type

assetsobject

Assets

item_assetsobject

Item Assets

See the Item Assets Definition Extension Specification

licensestring required

License identifier for the collection data.

keywordsstring[]

Keywords describing the collection.

summariesobject

Summaries

See the STAC Collection Spec.

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-preview28e8cb365289Revision changes
    • info

      api operation id StacCollectionOperations_Create removed and replaced with StacCollections_Create

  • 2025-04-30-preview00cbc3d6d8e0Revision changes
    • info

      api operation id StacCollections_Create removed and replaced with StacCollectionOperations_Create