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

# Delete Surveys

> Delete one or more surveys and all associated data that you own.

Delete one or more surveys that you own. This removes all associated data: respondents, respondent metadata, interaction data, flattened collections, quality settings, and the survey itself.


## OpenAPI

````yaml POST /v3/deleteSurveys
openapi: 3.0.1
info:
  title: API Documentation
  description: API Documentation for Redem 3.0
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://api.redem.io
security:
  - apiKeyAuth: []
tags:
  - name: Survey
    description: Survey management
  - name: Respondent
    description: Respondent management
paths:
  /v3/deleteSurveys:
    post:
      tags:
        - Survey
      summary: Delete surveys
      description: Delete one or more surveys and all associated data that you own.
      operationId: deleteSurveysV3
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: |-
                Request body for deleting surveys 

                 **🔒 Authentication:** This endpoint is only accessible via a `PRIVATE` API key type
              properties:
                surveyNames:
                  type: array
                  items:
                    type: string
                  minItems: 1
                  description: Array of survey names to delete.
              required:
                - surveyNames
      responses:
        '200':
          description: Successful deletion response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: >-
                      A variable indicating whether the **operation was
                      successful**.
                  message:
                    type: string
                    description: >-
                      A variable that **human-readable message** providing
                      additional context or confirmation of the requested
                      action.
                  results:
                    type: object
                    description: >-
                      This object serves as a **container to hold the results
                      for the requested data**, encapsulating all relevant
                      information and outputs in a structured format.
                    x-additionalPropertiesName: Survey Name
                    properties:
                      '{Survey Name}':
                        type: object
                        properties:
                          success:
                            type: boolean
                            description: >-
                              A variable indicating whether the **operation was
                              successful**.
                          deleted:
                            type: object
                            description: >-
                              This object serves as a **container to hold the
                              results for the requested data**, encapsulating
                              all relevant information and outputs in a
                              structured format.
                            properties:
                              respondents:
                                type: number
              example:
                success: true
                message: Surveys deleted successfully
                results:
                  Customer-Satisfaction-2025:
                    success: true
                    deleted:
                      respondents: 120
                  NPS-Q3-2025:
                    success: false
                    message: Survey not found or not owned by user
        '400':
          description: >-
            When a request fails due to invalid input or other errors, the API
            returns a 400 Bad Request status code. The response includes a
            descriptive message explaining the issue and an error object
            containing additional details to aid in diagnosing and resolving the
            problem.
          content:
            application/json:
              schema:
                type: object
              examples:
                Validation Error:
                  value:
                    success: false
                    message: Validation Error
                    errors:
                      '0': '"surveyNames" is required'
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: api-key

````