---
title: "Delete a chart"
method: DELETE
path: "/api/v3/charts/{chartId}"
tags: ["V3 Charts"]
---

# Delete a chart

`DELETE /api/v3/charts/{chartId}`

## Request

- Base URL: `https://app.formbricks.com`
- URL: `https://app.formbricks.com/api/v3/charts/{chartId}`
- Auth: one of:
  - API key in cookie `next-auth.session-token`
  - API key in header `x-api-key`
  - HTTP bearer

Deletes a chart that sits on no dashboard. A chart still on one is refused with 409
`chart_in_use`, naming those dashboards in `details.dashboards` — remove it from them first
(`DELETE /api/v3/dashboards/{dashboardId}/widgets/{widgetId}`); there is no force option. The
check and the delete are one transaction, so a widget added at the same moment is never removed
with the chart. Needs write access to the chart's workspace and, while its Feedback Dataset is
assigned to that workspace and not archived, to the dataset; a chart whose dataset was unassigned
or archived can still be deleted.

## Path parameters

- `chartId` string, cuid2, required

## Response `204`

Chart deleted

## Other responses

- `400`: Bad Request — malformed JSON, invalid query/body/params, duplicate name, or unsupported field.
- `401`: Not authenticated (no valid session or API key).
- `403`: Forbidden. `code: forbidden` when the caller has no access to the workspace, the Feedback Dataset or the resource (which may also not exist; 404 is not used, to avoid leaking existence). `code: dashboards_plan_required` when the caller is authorized but the organization does not have the Dashboards add-on or a license that includes it — checked after authorization, so a caller without access never learns the organization's plan.
- `409`: Conflict (`code: chart_in_use`) — the chart is on at least one dashboard, so nothing was deleted. `details.dashboards` lists them as `{ id, name }`.
- `429`: Rate limit exceeded.
- `500`: Internal Server Error.

## Changes

- **2026-10-28** `84820a01e550`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/formbricks/apis/formbricks-api-v3/changes/api/v3/charts/:chartId/delete.md)

---

[API](https://skmtc.dev/formbricks/apis/formbricks-api-v3.md) - [All operations](https://skmtc.dev/formbricks/apis/formbricks-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/formbricks/apis/formbricks-api-v3/revisions/25335c959a13?raw)