---
title: "add visualization"
method: POST
path: "/api/v1/visualizations"
tags: ["Visualizations"]
---

# add visualization

`POST /api/v1/visualizations`

This endpoint creates a visualization.

To add visualization to a dataset, provide a name, the dataset ID it corresponds to, and an attachment ID (the ID of the visualization file uploaded to Labguru).
Once added, the visualization will appear under the 'Visualizations' tab of a dataset.

For a detailed guide on creating dataset visualizations, including a step-by-step process and practical examples, refer to our comprehensive article: [How To Create Dataset Visualization](https://help.labguru.com/en/articles/8741020-how-to-create-dataset-visualization).

## Request body

- AddVisualization
  - `token` string, required
  - `item` object
    - `name` string, required — The name of the visualization
    - `dataset_id` integer, required — The ID of the dataset to which the visualization will be linked to
    - `attachment_id` integer, required — The ID of the attachment (image) that will appear under the 'Visualization' tab of the dataset

## Response `201`

Created

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/labguru/apis/labguru-api.md) · [All operations](https://skmtc.net/labguru/apis/labguru-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labguru/labguru-api/revisions/0534e4d70b77/schema)