Sign in
Datasets

Add Vrt Source

Add a COG source to an existing VRT and trigger async regeneration.

Validates the new source against existing sources synchronously. Returns 202 Accepted with a job_id for polling. Returns 409 if the VRT is currently regenerating or the source is already linked. Returns 422 if the source is incompatible with existing sources.

post/ingest/vrt/{dataset_id}/sources/

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

Path parameters

dataset_idstring uuid required

Request body

source_dataset_idstring uuid required

Raster dataset ID to add as an additional source to the existing VRT.

Response

Successful Response

job_idstring uuid required

Identifier of the asynchronous VRT mutation job.

statusstring

Initial job status.

messagestring required

Human-readable acceptance message.

Changes

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