---
title: "Create a plot"
method: POST
path: "/v0/projects/{project}/plots"
tags: ["projects", "plots"]
---

# Create a plot

`POST /v0/projects/{project}/plots`

Create a plot for a project. The user must have `create` permissions for the project. A project can have a maximum of 64 plots at a time.

## Path parameters

- `project` string, required

## Request body

- JsonNewPlot
  - `benchmarks` BenchmarkUuid[], required — The benchmarks to include in the plot. At least one benchmark must be specified.
  - `branches` BranchUuid[], required — The branches to include in the plot. At least one branch must be specified.
  - `index` integer
  - `lower_boundary` boolean, required — Display lower boundary limits.
  - `lower_value` boolean, required — Display metric lower values.
  - `measures` MeasureUuid[], required — The measures to include in the plot. At least one measure must be specified.
  - `testbeds` TestbedUuid[], required — The testbeds to include in the plot. At least one testbed must be specified.
  - `title` string
  - `upper_boundary` boolean, required — Display upper boundary limits.
  - `upper_value` boolean, required — Display metric upper values.
  - `window` integer, required
  - `x_axis` 'date_time' | 'version', required
  - `y_axis` union
    - 'auto' — Automatically adapt the y-axis scale to the data spread.
    - 'linear' — A linear y-axis scale that shows true magnitudes.
    - 'log' — A logarithmic y-axis scale.

## Response `201`

successful creation

- JsonPlot
  - `benchmarks` BenchmarkUuid[], required
  - `branches` BranchUuid[], required
  - `created` string, date-time, required
  - `lower_boundary` boolean, required
  - `lower_value` boolean, required
  - `measures` MeasureUuid[], required
  - `modified` string, date-time, required
  - `project` string, uuid, required
  - `testbeds` TestbedUuid[], required
  - `title` string
  - `upper_boundary` boolean, required
  - `upper_value` boolean, required
  - `uuid` string, uuid, required
  - `window` integer, required
  - `x_axis` 'date_time' | 'version', required
  - `y_axis` union, required
    - 'auto' — Automatically adapt the y-axis scale to the data spread.
    - 'linear' — A linear y-axis scale that shows true magnitudes.
    - 'log' — A logarithmic y-axis scale.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/bencherdev/apis/bencher-api.md) · [All operations](https://skmtc.net/bencherdev/apis/bencher-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bencherdev/bencher-api/versions/84086e99e6cd/schema)