---
title: "Render one figure to SVG"
method: POST
path: "/dashboards/v3/render/svg"
tags: ["Dashboard v3"]
---

# Render one figure to SVG

`POST /dashboards/v3/render/svg`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/dashboards/v3/render/svg`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Render one engine figure spec to a static SVG with no browser and no stored data; the CLI's Explore export uses it. The spec carries its data inline. A malformed spec is a 422; an engine failure is a 503 with the engine message in details.

## Request body

- RenderFigureSvgSpec: A figure spec and an optional style to render it in
  - `spec` object, required: Engine figure spec: the chart kind, title, width/height, and its data inline (data for charts, rows for a table)
  - `style_id` string, nullable: Stock or custom style id; null renders the engine default

## Response `200`

The rendered figure as SVG

- RenderFigureSvgResponse
  - `svg` string, required: The rendered figure as an <svg> document

## Other responses

- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)