---
title: "Create Figure"
method: POST
path: "/api/live-figures"
tags: ["live-visualization"]
---

# Create Figure

`POST /api/live-figures`

## Request body

- CreateLiveFigureRequest
  - `notebook_id` string, nullable
  - `session_id` string, nullable
  - `title` string, required
  - `spec` LiveFigureSpec, required
    - `version` 1
    - `kind` 'line'
    - `series` LiveSeries[], required
      - `id` string, required
      - `label` string, required
      - `source_claim_id` string, required
      - `x` string, required
      - `y` string, required
      - `filters` LiveFilter[]
        - `column` string, required
        - `op` 'eq'
        - `value` union, required
          - string
          - integer
          - number
          - boolean
      - `x_metric` string, nullable
      - `group_by_run` boolean
      - `run_segments` RunSegment[], nullable
        - `run_id` string, required
        - `segment_id` string, required
        - `label` string, nullable
    - `x_axis` LiveAxis
      - `label` string
      - `scale` 'linear' | 'log'
    - `y_axis` LiveAxis
      - `label` string
      - `scale` 'linear' | 'log'

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-23** `d7f2f3b8e82d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/api/live-figures/post.md)

---

[API](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/revisions/d7f2f3b8e82d?raw)