---
title: "Generate an index PNG for a visualization"
method: POST
path: "/v0/aois/{aoi_id}/visualizations/{visualization_id}/png"
tags: ["Visualizations"]
---

# Generate an index PNG for a visualization

`POST /v0/aois/{aoi_id}/visualizations/{visualization_id}/png`

## Request

- Base URL: `https://api.pixxel.space`
- URL: `https://api.pixxel.space/v0/aois/{aoi_id}/visualizations/{visualization_id}/png`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pixxel/apis/stargate/docs/v0/aois/:aoi_id/visualizations/:visualization_id/png/post.ts> (a function with typed inputs; its response is checked against the schema)

Generates an on-the-fly PNG of the index for a given date and mode, with legend overlay. Returns the PNG image as binary data.

## Path parameters

- `aoi_id` string, required
- `visualization_id` string, required

## Request body

- AtlasPngRequest
  - `index_id` string, required: UUID of the index to compute the preview for
  - `date` string, required: Date string, e.g. 2024_05_06
  - `visualization_mode` 'dynamic' | 'theoretical', required: Legend mode to use: 'dynamic' or 'theoretical'

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pixxel/apis/stargate.md) - [All operations](https://skmtc.dev/pixxel/apis/stargate/llms.txt) - [OpenAPI document](https://skmtc.dev/pixxel/apis/stargate/revisions/519562bd9d7a?raw)