Add Vrt Source
const url = 'https://example.com/ingest/vrt/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sources/';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"source_dataset_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/ingest/vrt/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sources/ \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "source_dataset_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'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 (SRC-05) or source already linked. Returns 422 if the source is incompatible with existing sources.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Request Body required
Section titled “Request Body required ”object
Raster dataset ID to add as an additional source to the existing VRT.
Example generated
{ "source_dataset_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Responses
Section titled “ Responses ”Successful Response
object
Identifier of the asynchronous VRT mutation job.
Human-readable acceptance message.
Initial job status.
Example
{ "status": "accepted"}Bad request — invalid payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks write access
Not found
Conflict — resource state prevents the operation
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “Headers ”Seconds until the request may be retried
Internal server error
Service unavailable — the database could not serve the request