---
canonical_url: "https://docs.composio.dev/toolkits/chartly"
markdown_url: "https://docs.composio.dev/toolkits/chartly.md"
product: "platform"
version: null
last_updated: null
---

# Chartly

Chartly renders Chart.js configurations as PNG or SVG images and creates permanent chart URLs for sharing and embedding.

- **Category:** images & design
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `CHARTLY`
- **Version:** 00000000_00

## Tools

### Create Permanent Chart

**Slug:** `CHARTLY_CREATE_PERMANENT_CHART`

Create a permanent Chartly URL from a Chart.js configuration. This creates an undeletable resource because Chartly provides no delete endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chart` | object | Yes | Complete Chart.js configuration to store behind the permanent URL, including chart type, data, datasets, and display options. |
| `width` | integer | Yes | Rendered image width in pixels (1-2000). |
| `format` | string ("png" | "svg") | No | Image format served by the permanent URL. |
| `height` | integer | Yes | Rendered image height in pixels (1-2000). |
| `background_color` | string | No | CSS background color for the chart, such as white, transparent, or #ffffff. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Permanent Chart

**Slug:** `CHARTLY_GET_PERMANENT_CHART`

Download the PNG or SVG image for an existing permanent Chartly chart ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chart_id` | string | Yes | Permanent chart ID returned by Create Permanent Chart or found at the end of its URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Render Chart

**Slug:** `CHARTLY_RENDER_CHART`

Render a Chart.js configuration as a PNG or SVG downloadable image without creating a permanent Chartly URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `chart` | object | Yes | Complete Chart.js configuration, including chart type, data, datasets, and display options. |
| `width` | integer | Yes | Rendered image width in pixels (1-2000). |
| `format` | string ("png" | "svg") | No | Output image format. |
| `height` | integer | Yes | Rendered image height in pixels (1-2000). |
| `background_color` | string | No | CSS background color for the image, such as white, transparent, or #ffffff. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |