Get Ingestion Tile Urls

Mint fresh overlay tile URL templates for a completed ingestion โ€” the raster layers behind the results map's layer picker.

Use Cases

  • Render the natural_forest, commodity, deforestation, fire, and flood overlays on a results map (each value is an XYZ raster tile URL template with {z}/{x}/{y} placeholders, directly usable by Mapbox / deck.gl / Leaflet raster layers).
  • Re-mint expired overlay URLs by calling the endpoint again.

Behaviour

  • URLs expire. Each URL embeds an expiring session token that lapses after a few hours. Never persist them โ€” re-fetch this endpoint to mint fresh ones. Responses are served from a short-lived server-side cache, safely inside the token lifetime.
  • Layers can be omitted. A layer whose generation fails, or whose mask is empty for the ingestion's area (commonly deforestation where no post-2020 alerts intersect), is omitted from tile_urls rather than failing the request. Treat the key set as dynamic.
  • The resource is computed on read, so data has no id.
  • The before/after satellite basemap is a separate concern โ€” see POST /imagery/tiles.

Errors

  • 404 NOT_FOUND โ€” unknown task id, or a task belonging to another organization.
  • 409 CONFLICT โ€” the ingestion has not reached a staged / completed / completed_with_errors state yet (overlay inputs don't exist before then), or it has no staged locations with geometry.
  • 502 IMAGERY_UPSTREAM_ERROR โ€” the upstream tile service is unavailable or minted no layers; retry later (nothing is cached on this path).

Required scope: ingestions:read