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

# Delete conversation

> Soft-deletes a conversation. The conversation will no longer appear in list requests, but the underlying data remains accessible from the dashboard.



## OpenAPI

````yaml /openapi/apps-api.json delete /apps/{app_id}/conversations/{conversation_id}
openapi: 3.1.0
info:
  title: Dimedove API
  version: 1.0.0
  description: >-
    Programmatically manage conversations and interact with your AI agents
    through the Dimedove API.
servers:
  - url: https://api.dimedove.com/v1
    description: Production
security: []
paths:
  /apps/{app_id}/conversations/{conversation_id}:
    delete:
      tags:
        - Conversations
      summary: Delete conversation
      description: >-
        Soft-deletes a conversation. The conversation will no longer appear in
        list requests, but the underlying data remains accessible from the
        dashboard.
      operationId: apps_api_delete_conversation
      parameters:
        - in: path
          name: app_id
          schema:
            description: The unique identifier of the app.
            title: App Id
            type: string
          required: true
          description: The unique identifier of the app.
        - in: path
          name: conversation_id
          schema:
            description: The unique identifier of the conversation.
            title: Conversation Id
            type: string
          required: true
          description: The unique identifier of the conversation.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationDeleteResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIErrorSchema'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIErrorSchema'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIErrorSchema'
      security:
        - AppsApiKeyAuth: []
components:
  schemas:
    ConversationDeleteResponse:
      properties:
        id:
          description: The ID of the deleted conversation.
          title: Id
          type: string
        object:
          default: conversation
          description: The object type. Always 'conversation'.
          title: Object
          type: string
        deleted:
          default: true
          description: Indicates the conversation was successfully deleted. Always true.
          title: Deleted
          type: boolean
      required:
        - id
      title: ConversationDeleteResponse
      type: object
    OpenAIErrorSchema:
      properties:
        error:
          $ref: '#/components/schemas/OpenAIErrorDetail'
          description: The error detail object.
      required:
        - error
      title: OpenAIErrorSchema
      type: object
    OpenAIErrorDetail:
      properties:
        message:
          description: A human-readable description of the error.
          title: Message
          type: string
        type:
          description: >-
            The error type identifier (e.g. 'invalid_api_key', 'not_found',
            'rate_limit_exceeded').
          title: Type
          type: string
        param:
          anyOf:
            - type: string
            - type: 'null'
          description: The parameter that caused the error, if applicable.
          title: Param
        code:
          anyOf:
            - type: string
            - type: 'null'
          description: An error code providing additional detail, if applicable.
          title: Code
      required:
        - message
        - type
      title: OpenAIErrorDetail
      type: object
  securitySchemes:
    AppsApiKeyAuth:
      type: http
      scheme: bearer

````