---
title: "Delete a user-submitted custom component"
method: POST
path: "/api/admin/custom-components/delete"
tags: ["admin-catalog-tools"]
---

# Delete a user-submitted custom component

`POST /api/admin/custom-components/delete`

## Request

- Base URL: `https://voltplan.app`
- URL: `https://voltplan.app/api/admin/custom-components/delete`
- Auth: HTTP bearer

Deletes the `custom_components` record with the given id using the PocketBase superuser client. An unknown id is reported as 500 (the PocketBase 404 is not mapped).

## Request body

- AdminCatalogDeleteCustomComponentRequest
  - `id` string, required: Id of the `custom_components` record.

## Response `200`

Record deleted.

- AdminCatalogDeleteCustomComponentResponse
  - `success` unknown, required

## Other responses

- `400`: `id` is missing or empty.
- `403`: Admin access required. Returned for a missing, invalid or expired bearer token as well as for a valid token whose user lacks `is_admin=true`; admin endpoints never answer 401.
- `500`: Malformed JSON body, unknown id, PocketBase error, or admin credentials not configured.

---

[API](https://skmtc.dev/voltplan/apis/voltplan-api.md) · [All operations](https://skmtc.dev/voltplan/apis/voltplan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voltplan/apis/voltplan-api/revisions/575b86a7af92?raw)