Donut Chart Generator

Donut Chart Generator

What it does

Donut Chart Generator creates donut chart images from a title, chart data, and an optional theme. Send a title and a data array of labeled values; each item can also include a 6-character hex color without the # prefix. You can set theme to light or dark, and the deprecated slices field is still accepted as an alias for data, but not both in the same request.

Use POST /download when you want the rendered chart as a binary image. Use POST /link when you want a pre-signed URL back in a JSON response. In both cases, the service is built around the same chart definition, so you can generate the image once and reuse the link in emails, dashboards, reports, or internal admin tools.

This is a good fit for visualizing category splits, subscription status, survey results, or other part-to-whole metrics. For example, you can turn Active, Trial, and Cancelled counts into a chart with a clear title and custom slice colors, then embed the result wherever your application needs a compact summary graphic.

curl -X POST "https://api.eu.apyverse.com/apyhub/generate-donut-chart/download" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Subscription Status Breakdown", "data": [ { "color": "10B981", "label": "Active", "value": 72 }, { "color": "3B82F6", "label": "Trial", "value": 18 }, { "color": "EF4444", "label": "Cancelled", "value": 10 } ] }'

About this endpoint

What it does

Generates a donut chart image from the chart configuration sent in the request body and returns the image as binary data.

Request Body

Parameter	Type	Mandatory	Description
title	String	Yes	Chart title. Minimum length 1.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
data	Object Array	Yes	Chart data points to render. At least 1 item required.
data[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].label	String	Yes	Slice label.
data[].value	Number	Yes	Slice value. Must be 0 or greater.
slices	Object Array	No	Alias for `data`. Deprecated. Use either `data` or `slices`, not both. At least 1 item required.
slices[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
slices[].label	String	Yes	Slice label.
slices[].value	Number	Yes	Slice value. Must be 0 or greater.

Response

Returns a binary file response containing the generated chart image.

Parameter	Type	Mandatory	Description
binary	String	Yes	Binary image data returned by the endpoint.

curl -X POST "https://api.eu.apyverse.com/apyhub/generate-donut-chart/link" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Subscription Status Breakdown", "data": [ { "color": "10B981", "label": "Active", "value": 72 }, { "color": "3B82F6", "label": "Trial", "value": 18 }, { "color": "EF4444", "label": "Cancelled", "value": 10 } ] }'

About this endpoint

What it does

Generates a donut chart link from the chart configuration in the request body and returns a JSON object containing a pre-signed URL for the generated chart image.

Request Body

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Chart slices to render. Each item must include `label` and `value`; `color` is optional.
data[].label	String	Yes	Slice label.
data[].value	Number	Yes	Slice value. Must be greater than or equal to 0.
data[].color	String	No	6-character hex color without the leading `#` symbol.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title. Must be at least 1 character.
slices	Object Array	No	Alias for `data`. Use either `data` or `slices`, not both. Each item must include `label` and `value`; `color` is optional. Deprecated.
slices[].label	String	Yes	Slice label.
slices[].value	Number	Yes	Slice value. Must be greater than or equal to 0.
slices[].color	String	No	6-character hex color without the leading `#` symbol. Deprecated.

Response

Returns a JSON object with a data string field. The data value is a URI that points to the generated chart image.

Parameter	Type	Mandatory	Description
data	String	Yes	Pre-signed URL for the generated chart image.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Query parameters

Body

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Query parameters

Body

Errors any endpoint can return