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

# Delete a comment for a control within an audit

> Deletes an existing comment on a control. Only the original author
of the comment can delete it. The author is identified by their email address,
which must match the email of the user who created the comment.

Rate limit: 10 requests / minute.



## OpenAPI

````yaml https://spec.speakeasy.com/vanta/vanta/conduct-an-audit-with-code-samples delete /audits/{auditId}/controls/{controlId}/comments/{commentId}
openapi: 3.0.0
info:
  title: Conduct an audit
  version: 1.0.0
  description: >-
    The Auditor API lets audit firms conduct audits from a tool outside of
    Vanta. Unlock data syncing with Vanta through this API.


    **Note for Vanta Gov (FedRAMP) customers:** Select `Vanta Gov (FedRAMP)`
    from the server dropdown to issue requests against
    `https://api.vanta-gov.com`. The OAuth token URL shown below defaults to the
    commercial host — replace it with `https://api.vanta-gov.com/oauth/token`.
  termsOfService: https://www.vanta.com/terms
  license:
    name: UNLICENSED
  contact:
    name: API Support
    url: https://help.vanta.com/
    email: support@vanta.com
servers:
  - url: https://api.vanta.com/v1
    description: US Region API
  - url: https://api.vanta-gov.com/v1
    description: Vanta Gov (FedRAMP)
security: []
paths:
  /audits/{auditId}/controls/{controlId}/comments/{commentId}:
    delete:
      tags:
        - Audits
      summary: Delete a comment for a control within an audit
      description: >-
        Deletes an existing comment on a control. Only the original author

        of the comment can delete it. The author is identified by their email
        address,

        which must match the email of the user who created the comment.


        Rate limit: 10 requests / minute.
      operationId: DeleteCommentForControl
      parameters:
        - in: path
          name: auditId
          required: true
          schema:
            type: string
        - in: path
          name: controlId
          required: true
          schema:
            type: string
        - in: path
          name: commentId
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteAuditControlCommentInput'
      responses:
        '204':
          description: No content
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: typescript
          label: DeleteCommentForControl
          source: |-
            import { Vanta } from "vanta-auditor-api-sdk";

            const vanta = new Vanta({
              bearerAuth: process.env["VANTA_BEARER_AUTH"] ?? "",
            });

            async function run() {
              await vanta.audits.deleteCommentForControl({
                auditId: "<id>",
                controlId: "<id>",
                commentId: "<id>",
                deleteAuditControlCommentInput: {
                  email: "Lorenzo.Ondricka@yahoo.com",
                },
              });


            }

            run();
        - lang: java
          label: DeleteCommentForControl
          source: >-
            package hello.world;


            import com.vanta.vanta_auditor_api.Vanta;

            import
            com.vanta.vanta_auditor_api.models.components.DeleteAuditControlCommentInput;

            import
            com.vanta.vanta_auditor_api.models.operations.DeleteCommentForControlResponse;

            import java.lang.Exception;


            public class Application {

                public static void main(String[] args) throws Exception {

                    Vanta sdk = Vanta.builder()
                            .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
                        .build();

                    DeleteCommentForControlResponse res = sdk.audits().deleteCommentForControl()
                            .auditId("<id>")
                            .controlId("<id>")
                            .commentId("<id>")
                            .deleteAuditControlCommentInput(DeleteAuditControlCommentInput.builder()
                                .email("Lorenzo.Ondricka@yahoo.com")
                                .build())
                            .call();

                    // handle response
                }
            }
components:
  schemas:
    DeleteAuditControlCommentInput:
      description: |-
        Deletes an existing comment on a control.
        Only the original author of the comment can delete it.
      properties:
        email:
          type: string
          description: >-
            Email address of the comment author.

            Must match an existing Vanta user who belongs to the audit firm
            making the API request.

            This email uniquely identifies the author across systems.
      required:
        - email
      type: object
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````