---
title: "DELETE /characters/{id} | MakeAIVideo"
description: "Delete a workspace character. DELETE /characters/{id} in the MakeAIVideo API, with request fields and every response code. 1 parameter. Needs an API key wi..."
canonical: https://makeaivideo.ai/docs/api/characters/delete-character
format: markdown
generator: makeaivideo-marketing build-time HTML→MD
---

[Documentation](/docs)v1.2

Guides

-   [Overview](/docs)
-   [Quickstart](/docs/quickstart)
-   [Authentication](/docs/authentication)
-   [Webhooks](/docs/webhooks)

Integrations

-   [MCP server](/docs/mcp)
-   [Agents](/docs/agents)
-   [CLI](/docs/cli)
-   [TypeScript SDK](/docs/sdk)

API reference

-   [All endpoints](/docs/api)
-   [Introspection](/docs/api/introspection)
-   [Videos](/docs/api/videos)
-   [Scripts](/docs/api/scripts)
-   [Characters](/docs/api/characters)
-   [Voices](/docs/api/voices)
-   [Music](/docs/api/music)
-   [Uploads](/docs/api/uploads)
-   [Brand kit](/docs/api/brand-kit)
-   [Workspace](/docs/api/workspace)
-   [Ideas](/docs/api/ideas)
-   [Publishing](/docs/api/publishing)
-   [Webhooks](/docs/api/webhooks)
-   [Auth](/docs/api/auth)

# DELETE`/characters/{id}`

Delete a workspace character

## Request

Send to `https://app.makeaivideo.ai/api/v1/characters/{id}` with a bearer API key. The key needs the `write` scope; a key without it gets `403 forbidden` naming the scope it lacks.

### Parameters

Name

In

Required

Description

id

path

yes

Numeric character id

## Responses

Every v1 response is `{ data, error, meta }`. On failure `error` carries a stable `code` and `meta.request_id` identifies the call, which is the thing to quote in a support mail.

Status

Meaning

200

Deleted

## Other characters endpoints

-   [GET`/characters`Preset and workspace characters](/docs/api/characters/list-characters)
-   [POST`/characters`Save a character from generated or uploaded assets](/docs/api/characters/create-character)
-   [GET`/characters/{id}`Character detail with signed asset URLs](/docs/api/characters/get-character)
-   [PATCH`/characters/{id}`Update name, description or voice](/docs/api/characters/update-character)
-   [POST`/characters/variations`Generate 1-4 portrait candidates (spends credits)](/docs/api/characters/generate-portraits)
-   [POST`/characters/voice-previews`Candidate voices reading a sample line](/docs/api/characters/generate-voice-previews)

[All characters](/docs/api/characters) · [Full API reference](/docs/api) · [TypeScript SDK](/docs/sdk) · [Quickstart](/docs/quickstart)
