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

# delete avatar video

> Cancels the job if it is still running, then deletes its recording, session report and job content. Returns 200 once everything is deleted, or 202 when Lab finishes the deletion in the background, either because the session is still ending or because a delete failed and will be retried. Background deletion runs every minute and keeps retrying until it succeeds. The job row stays, without content, and a retry returns 409 content_expired. Repeating the call is safe.



## OpenAPI

````yaml https://api.anam.ai/swagger.json delete /v1/avatar-videos/{id}
openapi: 3.1.0
info:
  title: Anam AI API
  version: '1.0'
servers:
  - url: https://api.anam.ai
    description: Anam API
security:
  - BearerAuth: []
tags:
  - name: Sessions
  - name: Avatar Videos
  - name: Meetings
  - name: Watermark Checks
  - name: Personas
  - name: Avatars
  - name: Voices
  - name: Pronunciation Dictionaries
  - name: LLMs
  - name: Knowledge
  - name: Tools
  - name: Share Links
  - name: Engine
paths:
  /v1/avatar-videos/{id}:
    delete:
      tags:
        - Avatar Videos
      summary: Delete an avatar video
      description: >-
        Cancels the job if it is still running, then deletes its recording,
        session report and job content. Returns 200 once everything is deleted,
        or 202 when Lab finishes the deletion in the background, either because
        the session is still ending or because a delete failed and will be
        retried. Background deletion runs every minute and keeps retrying until
        it succeeds. The job row stays, without content, and a retry returns 409
        content_expired. Repeating the call is safe.
      operationId: deleteAvatarVideo
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
          example: avv_123
      responses:
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - deletedAt
                properties:
                  id:
                    type: string
                  deletedAt:
                    type: string
                    format: date-time
        '202':
          description: Scheduled; Lab deletes it in the background
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - deleteAt
                properties:
                  id:
                    type: string
                  deleteAt:
                    type: string
                    format: date-time
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvatarVideoError'
        '403':
          description: API key lacks avatar-video write access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvatarVideoError'
        '404':
          description: Avatar video not found in this organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvatarVideoError'
        '503':
          description: >-
            The API key could not be checked because of a temporary server
            problem. The key may be valid; retry after `Retry-After` seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AvatarVideoError'
components:
  schemas:
    AvatarVideoError:
      type: object
      required:
        - code
        - message
        - requestId
        - retryable
      properties:
        code:
          type: string
          description: Stable machine-readable failure code.
        message:
          type: string
        requestId:
          type: string
        retryable:
          type: boolean
        details:
          type: object
          additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.