---
title: "Figures"
method: POST
path: "/projects/{project_id}/dashboards/figures"
tags: ["dashboards"]
---

# Figures

`POST /projects/{project_id}/dashboards/figures`

Render the requested plots. A plot that fails comes back with ``ok=false``.

## Path parameters

- `project_id` string, uuid, required

## Request body

- FiguresRequest
  - `plots` PlotRequest[], required
    - `plot_id` string, uuid, required
    - `params` object

## Response `200`

Successful Response

- FiguresResponse
  - `figures` FigureResult[], required
    - `plot_id` string, uuid, nullable
    - `ok` boolean, required
    - `figure` object, nullable
    - `error` string, nullable
    - `warnings` string[]
    - `provenance_summary` object
    - `cached` boolean
    - `cost` Cost
      - `sources` integer
      - `rows` integer
      - `points` integer
      - `ms` integer
    - `summary` FigureSummary — What the agent sees about a rendered figure without the whole payload.
      - `traces` integer, required
      - `points` integer, required
      - `trace_names` string[], required
      - `x_range` number[], nullable
      - `y_range` number[], nullable
    - `datasets_summary` object, nullable
    - `controls` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `8ed5440390f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ionworks/apis/fastapi/changes/projects/:project_id/dashboards/figures/post.md)

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/ionworks/apis/fastapi/revisions/8ed5440390f0?raw)