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

# Delete Document

> Archive (soft-delete) a document. The document disappears from session listings and Get Document returns `404` for it afterwards. Deleting an already-deleted document is a no-op and still returns success.


Archive a document. It disappears from listings and [Get Document](/ekascribe/api-reference/documents/get-document) returns `404` afterwards. Idempotent.


## OpenAPI

````yaml DELETE /voice/api/v1/documents/{document_id}
openapi: 3.0.1
info:
  title: EkaScribe Protocol API (MedScribeAlliance v0.1)
  version: '0.1'
  description: >
    Session-based medical voice capture API implementing the MedScribeAlliance
    Protocol v0.1. Discover service capabilities, create a session, stream audio
    chunks, then end the session to trigger asynchronous transcription and
    structured-template extraction.
servers:
  - url: https://api.eka.care
    description: Production server
  - url: https://api.dev.eka.care
    description: Development server
security: []
paths:
  /voice/api/v1/documents/{document_id}:
    delete:
      tags:
        - documents
      summary: Delete Document
      description: >
        Archive (soft-delete) a document. The document disappears from session
        listings and Get Document returns `404` for it afterwards. Deleting an
        already-deleted document is a no-op and still returns success.
      parameters:
        - name: document_id
          in: path
          required: true
          description: Document ID to delete
          schema:
            type: string
            example: doc_9f8e7d6c
      responses:
        '200':
          description: Document archived
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  message:
                    type: string
                    example: Document deleted successfully
        '404':
          description: Document not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - auth: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Machine-readable error code.
              example: invalid_audio_format
            message:
              type: string
              description: Human-readable error message.
              example: Audio format 'audio/mp3' is not supported
            details:
              type: object
              additionalProperties: true
              description: Additional error context.
  securitySchemes:
    auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your auth token.

````