Skip to content
getgeolens.com
GeoLens Docs

Stac Import

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

Items to import (max 50 per request).

Array<object>
>= 1 items <= 50 items
StacImportItem
object
bbox
Any of:
Array<number>
collection
Any of:
string
<= 255 characters
data_asset_href
required
Data Asset Href

URL of the COG asset to reference.

string
<= 4096 characters
datetime_end
Any of:
string
<= 50 characters
datetime_start
Any of:
string
<= 50 characters
epsg
Any of:
integer
id
required
Id

STAC item ID.

string
<= 2048 characters
keywords
Keywords

Keywords from STAC collection.

Array<string>
default: <= 100 items
title
required
Title

Title to use for the GeoLens dataset.

string
<= 500 characters
url
required
Url

STAC API URL for provenance.

string
>= 1 characters <= 2048 characters
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
created
required
Created

Number of datasets created.

integer
errors
required
Errors

Number of items that failed.

integer
results
required
Results

Per-item import results.

Array<object>
StacImportResult
object
dataset_id
Any of:
string format: uuid
error
Any of:
string
item_id
required
Item Id

STAC item ID that was processed.

string
status
required
Status

Import result status.

string
Allowed values: created skipped error
skipped
required
Skipped

Number of items skipped (duplicates).

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

400

Section titled “400 ”

Bad request — invalid payload

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

403

Section titled “403 ”

Forbidden — caller lacks write access

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

404

Section titled “404 ”

Not found

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

409

Section titled “409 ”

Conflict — resource state prevents the operation

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

422

Section titled “422 ”

Validation error

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

429

Section titled “429 ”

Too many requests — retry after the advertised interval

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until the request may be retried

500

Section titled “500 ”

Internal server error

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

503

Section titled “503 ”

Service unavailable — the database could not serve the request

Media type application/problem+json
ProblemDetail
object
detail
required
Any of:
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}