Skip to content
getgeolens.com
GeoLens DocsEarly release

Stac Import

POST
/services/stac/import
 
curl --request POST \
  --url https://example.com/api/services/stac/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "url": "example", "items": [ { "id": "example", "collection": "example", "title": "example", "data_asset_href": "example", "bbox": [ 1 ], "epsg": 1, "datetime_start": "example", "datetime_end": "example", "keywords": [] } ], "visibility": "private" }'

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.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
StacImportRequest
object
url
required
Url

STAC API URL for provenance.

string
>= 1 characters <= 2048 characters
items
required
Items

Items to import (max 50 per request).

Array<object>
>= 1 items <= 50 items
StacImportItem
object
id
required
Id

STAC item ID.

string
<= 2048 characters
collection
Any of:
string
<= 255 characters
title
required
Title

Title to use for the GeoLens dataset.

string
<= 500 characters
data_asset_href
required
Data Asset Href

URL of the COG asset to reference.

string
<= 4096 characters
bbox
Any of:
Array<number>
epsg
Any of:
integer
datetime_start
Any of:
string
<= 50 characters
datetime_end
Any of:
string
<= 50 characters
keywords
Keywords

Keywords from STAC collection.

Array<string>
default: <= 100 items
visibility
Visibility

Visibility for imported datasets.

string
default: private
Allowed values: private restricted internal public

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
StacImportResponse
object
results
required
Results

Per-item import results.

Array<object>
StacImportResult
object
item_id
required
Item Id

STAC item ID that was processed.

string
dataset_id
Any of:
string format: uuid
status
required
Status

Import result status.

string
Allowed values: created skipped error
error
Any of:
string
created
required
Created

Number of datasets created.

integer
skipped
required
Skipped

Number of items skipped (duplicates).

integer
errors
required
Errors

Number of items that failed.

integer
Example 
{
  "results": [
    {
      "status": "created"
    }
  ]
}

400

Section titled “400 ”

Bad request — invalid payload

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

403

Section titled “403 ”

Forbidden — caller lacks write access

404

Section titled “404 ”

Not found

409

Section titled “409 ”

Conflict — resource state prevents the operation

422

Section titled “422 ”

Validation error

500

Section titled “500 ”

Internal server error