> ## Documentation Index
> Fetch the complete documentation index at: https://docs.viggle.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Character

> Soft-delete a character

Removes a character from your account. It'll stop showing up in [List Characters](/api-reference/characters/list), but any renders that already used it keep working just fine.

<Note>
  This is a **soft delete** — we mark the record inactive rather than wiping it for good. Heads up: deleting won't refund the credit you spent preprocessing it.
</Note>

## Path parameters

| Parameter      | Type   | Required | Description                   |
| -------------- | ------ | :------: | ----------------------------- |
| `character_id` | string |     ✅    | The character UUID to delete. |

## Response

```json theme={null}
{
  "success": true
}
```

## Example

<CodeGroup>
  ```python Python theme={null}
  import requests

  character_id = "YOUR_CHARACTER_ID"
  url = f"https://apis.viggle.ai/api/characters/{character_id}"
  headers = {"Authorization": "Bearer YOUR_API_KEY"}

  response = requests.delete(url, headers=headers)
  response.raise_for_status()

  print("Character deleted successfully")
  ```

  ```javascript JavaScript theme={null}
  const characterId = "YOUR_CHARACTER_ID";

  const response = await fetch(`https://apis.viggle.ai/api/characters/${characterId}`, {
    method: "DELETE",
    headers: { "Authorization": "Bearer YOUR_API_KEY" },
  });

  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  console.log("Character deleted successfully");
  ```

  ```bash cURL theme={null}
  curl -X DELETE https://apis.viggle.ai/api/characters/YOUR_CHARACTER_ID \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</CodeGroup>


## OpenAPI

````yaml DELETE /api/characters/{character_id}
openapi: 3.0.3
info:
  title: Viggle API
  description: Generate AI-powered character animation videos
  version: 2.0.0
  contact:
    name: Viggle Support
    url: https://viggle.ai
servers:
  - url: https://apis.viggle.ai
    description: Production server
security: []
paths:
  /api/characters/{character_id}:
    delete:
      tags:
        - Characters
      summary: Delete Character
      description: >-
        Soft-delete a character. The character will no longer appear in lists
        but existing renders using it are not affected.
      operationId: deleteCharacter
      parameters:
        - name: character_id
          in: path
          required: true
          schema:
            type: string
          example: 550e8400-e29b-41d4-a716-446655440000
      responses:
        '200':
          description: Character deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Deleted'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Character not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorStructured'
              example:
                detail:
                  error_code: CS-UORC01-003
                  message: Character not found. Double-check the character_id.
      security:
        - bearerAuth: []
components:
  schemas:
    Deleted:
      type: object
      properties:
        success:
          type: boolean
          example: true
    ErrorStructured:
      type: object
      description: >-
        Structured error. `detail` carries a machine-readable `error_code` plus
        a human-readable `message`.
      properties:
        detail:
          type: object
          properties:
            error_code:
              type: string
              example: CS-UORC01-008
            message:
              type: string
              example: Insufficient credits. Top up your balance to continue.
    Error:
      type: object
      description: >-
        Simple error. `detail` is a human-readable message (used for auth
        errors).
      properties:
        detail:
          type: string
          example: 'API key required. Use Authorization: Bearer sk-xxx'
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            detail: >-
              Invalid or missing API key. Pass it as Authorization: Bearer
              sk-...
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key passed as Bearer token

````