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 or the source is 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.
Initial job status.
Human-readable acceptance message.
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