Sign in
STAC Import

Stac Import

Import selected STAC items as raster datasets.

Each item is registered as a raster_dataset record referencing the remote COG asset URL. Titiler serves the tiles directly from the remote source — no file download required.

post/services/stac/import

Request

  • The document declares no server URL.
  • Auth: one of:
    • OAuth 2 (password, token URL /api/auth/login)
    • API key in header X-Api-Key
    • API key in query parameter api_key

Request body

urlstring required

STAC API URL for provenance.

visibility'private' | 'restricted' | 'internal' | 'public'

Visibility for imported datasets.

catalog_auth_requiredboolean

Whether browsing this catalog needed a credential. Set it when the search that produced these items carried one, so the first refresh asks for a credential instead of failing anonymously.

Response

Successful Response

createdinteger required

Number of datasets created.

skippedinteger required

Number of items skipped (duplicates).

errorsinteger required

Number of items that failed.

Changes

No recorded changes to this operation across all 50 revisions of this API.