Delete a response

curl --request DELETE \
  --url https://app.formbricks.com/api/v3/responses/{responseId} \
  --cookie next-auth.session-token=

import requests

url = "https://app.formbricks.com/api/v3/responses/{responseId}"

headers = {"cookie": "next-auth.session-token="}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {cookie: 'next-auth.session-token='}};

fetch('https://app.formbricks.com/api/v3/responses/{responseId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.formbricks.com/api/v3/responses/{responseId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_COOKIE => "next-auth.session-token=",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.formbricks.com/api/v3/responses/{responseId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("cookie", "next-auth.session-token=")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.formbricks.com/api/v3/responses/{responseId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["cookie"] = 'next-auth.session-token='

response = http.request(request)
puts response.read_body

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

V3 Responses

Delete a response

Permanently deletes a response. Requires manage access; the workspace is resolved from the response, and an unknown or inaccessible responseId answers 403.

Deletion cascades to any files uploaded with the response, which are removed from storage after the row is committed. No responseDeleted webhook is emitted — no such trigger exists.

The Hub copy is not removed. A submission forwarded to the Hub stays there and stays searchable through the feedback-record endpoints after this returns 204. That cascade is ENG-2855 and lands after the Hub release; until then, an erasure workflow has to delete the feedback record itself. Stated because a caller cannot cheaply verify deletion semantics on a destructive endpoint.

DELETE

api

responses

{responseId}

Delete a response

curl --request DELETE \
  --url https://app.formbricks.com/api/v3/responses/{responseId} \
  --cookie next-auth.session-token=

import requests

url = "https://app.formbricks.com/api/v3/responses/{responseId}"

headers = {"cookie": "next-auth.session-token="}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {cookie: 'next-auth.session-token='}};

fetch('https://app.formbricks.com/api/v3/responses/{responseId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.formbricks.com/api/v3/responses/{responseId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_COOKIE => "next-auth.session-token=",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.formbricks.com/api/v3/responses/{responseId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("cookie", "next-auth.session-token=")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.formbricks.com/api/v3/responses/{responseId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["cookie"] = 'next-auth.session-token='

response = http.request(request)
puts response.read_body

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "type": "<string>",
  "instance": "<string>",
  "code": "ai_features_not_enabled",
  "details": {},
  "invalid_params": [
    {
      "name": "<string>",
      "reason": "<string>",
      "code": "dangling_reference",
      "identifier": "<string>",
      "referenceType": "block",
      "missingId": "<string>",
      "firstUsedAt": "<string>",
      "conflictsWith": "<string>"
    }
  ]
}

Authorizations

next-auth.session-token

string

required

NextAuth session JWT cookie. Development: often next-auth.session-token. Production (HTTPS): often __Secure-next-auth.session-token. Send the cookie your browser receives after sign-in.

Path Parameters

responseId

string<cuid2>

required

Response identifier.

Response

Response deleted successfully. No body.

API v3 Documentation (Private Beta)

V3 Surveys

V3 Responses

V3 Workflows

V3 Action Classes

V3 Contact Attribute Keys

V3 Workspaces

V3 Feedback Records

Delete a response

Authorizations

Path Parameters

Response