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

# Delete Calls

> Deletes one or more calls



## OpenAPI

````yaml delete /v1/Call
openapi: 3.0.1
info:
  title: NLPearl Client API
  description: A sample API that demonstrates features in the OpenAPI specification
  version: v1
servers:
  - url: https://api.nlpearl.ai
    description: Production Environement
security:
  - bearer_auth: []
paths:
  /v1/Call:
    delete:
      tags:
        - Call
      summary: Delete Calls
      description: Deletes one or more calls
      requestBody:
        description: The request object containing the list of call IDs to be deleted.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/DeleteCallsRequestApi'
              description: Represents the request object used to delete one or more calls.
          text/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/DeleteCallsRequestApi'
              description: Represents the request object used to delete one or more calls.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/DeleteCallsRequestApi'
              description: Represents the request object used to delete one or more calls.
      responses:
        '200':
          description: Returns a boolean indicating if the deletion was successful.
          content:
            text/plain:
              schema:
                type: boolean
            application/json:
              schema:
                type: boolean
            text/json:
              schema:
                type: boolean
        '400':
          description: Error
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
components:
  schemas:
    DeleteCallsRequestApi:
      type: object
      properties:
        callIds:
          type: array
          items:
            type: string
          description: The list of unique identifiers of the calls to delete.
          nullable: true
        purgeOption:
          allOf:
            - $ref: '#/components/schemas/CallRetentionPurge'
          description: >-
            Optional. Determines how much of each call is removed. When
            provided, the calls are kept and only the parts flagged true are
            stripped (transcript, recording, summary, variables). When omitted,
            each call is fully deleted: every part is purged, the recording is
            removed, and the call is marked as deleted.
          nullable: true
      additionalProperties: false
      description: Represents the request object used to delete one or more calls.
    ValidationProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: {}
    CallRetentionPurge:
      type: object
      properties:
        transcript:
          type: boolean
          description: When true, removes the call transcript.
        recording:
          type: boolean
          description: >-
            When true, removes the call recording (including the stored audio
            file).
        summary:
          type: boolean
          description: When true, removes the call summary.
        variables:
          type: boolean
          description: >-
            When true, removes the information collected during the call
            (variables).
      additionalProperties: false
      description: "Purge selection. When this object is provided, the call is kept and only the parts flagged\r\n`true` are removed (parts left `false` are kept). When it is omitted, the call is\r\nfully deleted: every part is removed and the call is marked as deleted."
  securitySchemes:
    bearer_auth:
      type: http
      description: >-
        Specify the authorization token.


        For more information, check out the [Authorization
        Guide](/api-reference/authorization).
      scheme: bearer

````