---
title: "Create Figure"
method: POST
path: "/figures/"
tags: ["Figures"]
---

# Create Figure

`POST /figures/`

Create a new figure and start async generation.

## Request body

- CreateFigureRequest
  - `image_urls` string[], nullable
  - `description` string, nullable
  - `instructions` string, nullable
  - `exercise_content` string, nullable
  - `current_code` string, nullable
  - `current_diagram_url` string, nullable
  - `source_type` string, nullable

## Response `200`

Successful Response

- CreateFigureResponse
  - `figure_id` string, required
  - `status` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/8d495ed916c6/schema)