---
title: Generate Donut Graph API
slug: mono-go-simple-donut-chart-generation
url: https://apyhub.com/apyhub/service/mono-go-simple-donut-chart-generation
provider: ApyHub
categories: [Smart Generation]
tags: [donut, chart, generate, graph]
auth: api_key
---

# Generate Donut Graph API

Generate donut chart images from a title and labeled data. Get a binary image or a pre-signed URL for dashboards, reports, and status breakdowns.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/download` | What it does Generates a donut chart image from the request body and returns it as binary data. The… | 60 |
| POST | `/link` | What it does Generates a donut chart and returns a pre-signed URL for the generated chart image. Re… | 60 |

## About

## What it does
Donut Chart Generator creates a donut chart from your data and returns either a downloadable chart image or a pre-signed image link. Send a title, a data array, and an optional theme; each data item can include a label, value, and hex color.

Use `data` to define the chart segments. Each item must include `label` and `value`, and `color` is optional as a 6-character hex string without the `#`. The `theme` can be `light` or `dark`, with `light` as the default. The service also accepts `slices` as a deprecated alias for `data`, so you can keep older integrations working while you migrate.

Choose `POST /download` when you want the generated chart image itself. It returns a binary response suitable for direct file handling. Choose `POST /link` when you want a JSON response containing a `data` field with a pre-signed URL to the generated chart image.

This is useful when you need charts for dashboards, reports, status pages, or automated notifications where the visualization is built from live application data. You control the title and segment labels, so the chart can reflect subscription breakdowns, sales mix, usage tiers, or any other labeled distribution.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/mono-go-simple-donut-chart-generation