---
title: "Changes to Delete a survey"
method: DELETE
path: "/api/v3/surveys/{surveyId}"
---

# Changes to Delete a survey

`DELETE /api/v3/surveys/{surveyId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 21 revisions.

- **2026-08-04** `aa2a946d376d` — 5 warning
- **2026-07-31** `252a618df054` — 40 warning
- **2026-07-30** `9010a37ad024` — 5 warning
- **2026-06-24** `b5349eecf1e6` — 10 warning
- **2026-06-05** `90798c12f7ae` — 30 warning
- **2026-05-28** `b514d6392200` — 35 info
- **2026-05-28** `23ec9fd15a38` — 1 breaking, 6 info
- **2026-04-17** `6e736eb7b23c` — 1 info
- **2026-03-20** `9fa9931e1a70` — 1 breaking

## Changes

- **2026-08-04** `aa2a946d376d` — 5 warning
  - added the new `service_unavailable` enum value to the `code` response property for the response status `400`
  - added the new `service_unavailable` enum value to the `code` response property for the response status `401`
  - added the new `service_unavailable` enum value to the `code` response property for the response status `403`
  - added the new `service_unavailable` enum value to the `code` response property for the response status `429`
  - added the new `service_unavailable` enum value to the `code` response property for the response status `500`
- **2026-07-31** `252a618df054` — 40 warning
  - added the new `conflict` enum value to the `code` response property for the response status `400`
  - added the new `conflict` enum value to the `code` response property for the response status `401`
  - added the new `conflict` enum value to the `code` response property for the response status `403`
  - added the new `conflict` enum value to the `code` response property for the response status `429`
  - added the new `conflict` enum value to the `code` response property for the response status `500`
  - added the new `edge` enum value to the `invalid_params/items/referenceType` response property for the response status `400`
  - added the new `edge` enum value to the `invalid_params/items/referenceType` response property for the response status `401`
  - added the new `edge` enum value to the `invalid_params/items/referenceType` response property for the response status `403`
  - added the new `edge` enum value to the `invalid_params/items/referenceType` response property for the response status `429`
  - added the new `edge` enum value to the `invalid_params/items/referenceType` response property for the response status `500`
  - added the new `endingCard` enum value to the `invalid_params/items/referenceType` response property for the response status `400`
  - added the new `endingCard` enum value to the `invalid_params/items/referenceType` response property for the response status `401`
  - added the new `endingCard` enum value to the `invalid_params/items/referenceType` response property for the response status `403`
  - added the new `endingCard` enum value to the `invalid_params/items/referenceType` response property for the response status `429`
  - added the new `endingCard` enum value to the `invalid_params/items/referenceType` response property for the response status `500`
  - added the new `invalid_graph` enum value to the `invalid_params/items/code` response property for the response status `400`
  - added the new `invalid_graph` enum value to the `invalid_params/items/code` response property for the response status `401`
  - added the new `invalid_graph` enum value to the `invalid_params/items/code` response property for the response status `403`
  - added the new `invalid_graph` enum value to the `invalid_params/items/code` response property for the response status `429`
  - added the new `invalid_graph` enum value to the `invalid_params/items/code` response property for the response status `500`
  - added the new `invalid_workflow_state` enum value to the `code` response property for the response status `400`
  - added the new `invalid_workflow_state` enum value to the `code` response property for the response status `401`
  - added the new `invalid_workflow_state` enum value to the `code` response property for the response status `403`
  - added the new `invalid_workflow_state` enum value to the `code` response property for the response status `429`
  - added the new `invalid_workflow_state` enum value to the `code` response property for the response status `500`
  - added the new `node` enum value to the `invalid_params/items/referenceType` response property for the response status `400`
  - added the new `node` enum value to the `invalid_params/items/referenceType` response property for the response status `401`
  - added the new `node` enum value to the `invalid_params/items/referenceType` response property for the response status `403`
  - added the new `node` enum value to the `invalid_params/items/referenceType` response property for the response status `429`
  - added the new `node` enum value to the `invalid_params/items/referenceType` response property for the response status `500`
  - added the new `survey` enum value to the `invalid_params/items/referenceType` response property for the response status `400`
  - added the new `survey` enum value to the `invalid_params/items/referenceType` response property for the response status `401`
  - added the new `survey` enum value to the `invalid_params/items/referenceType` response property for the response status `403`
  - added the new `survey` enum value to the `invalid_params/items/referenceType` response property for the response status `429`
  - added the new `survey` enum value to the `invalid_params/items/referenceType` response property for the response status `500`
  - added the new `workflow_not_executable` enum value to the `code` response property for the response status `400`
  - added the new `workflow_not_executable` enum value to the `code` response property for the response status `401`
  - added the new `workflow_not_executable` enum value to the `code` response property for the response status `403`
  - added the new `workflow_not_executable` enum value to the `code` response property for the response status `429`
  - added the new `workflow_not_executable` enum value to the `code` response property for the response status `500`
- **2026-07-30** `9010a37ad024` — 5 warning
  - added the new `ai_output_too_long` enum value to the `code` response property for the response status `400`
  - added the new `ai_output_too_long` enum value to the `code` response property for the response status `401`
  - added the new `ai_output_too_long` enum value to the `code` response property for the response status `403`
  - added the new `ai_output_too_long` enum value to the `code` response property for the response status `429`
  - added the new `ai_output_too_long` enum value to the `code` response property for the response status `500`
- **2026-06-24** `b5349eecf1e6` — 10 warning
  - added the new `not_found` enum value to the `code` response property for the response status `400`
  - added the new `not_found` enum value to the `code` response property for the response status `401`
  - added the new `not_found` enum value to the `code` response property for the response status `403`
  - added the new `not_found` enum value to the `code` response property for the response status `429`
  - added the new `not_found` enum value to the `code` response property for the response status `500`
  - added the new `payload_too_large` enum value to the `code` response property for the response status `400`
  - added the new `payload_too_large` enum value to the `code` response property for the response status `401`
  - added the new `payload_too_large` enum value to the `code` response property for the response status `403`
  - added the new `payload_too_large` enum value to the `code` response property for the response status `429`
  - added the new `payload_too_large` enum value to the `code` response property for the response status `500`
- **2026-06-05** `90798c12f7ae` — 30 warning
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `400`
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `401`
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `403`
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `429`
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `500`
  - added the new `ai_generated_payload_invalid` enum value to the `code` response property for the response status `400`
  - added the new `ai_generated_payload_invalid` enum value to the `code` response property for the response status `401`
  - added the new `ai_generated_payload_invalid` enum value to the `code` response property for the response status `403`
  - added the new `ai_generated_payload_invalid` enum value to the `code` response property for the response status `429`
  - added the new `ai_generated_payload_invalid` enum value to the `code` response property for the response status `500`
  - added the new `ai_instance_not_configured` enum value to the `code` response property for the response status `400`
  - added the new `ai_instance_not_configured` enum value to the `code` response property for the response status `401`
  - added the new `ai_instance_not_configured` enum value to the `code` response property for the response status `403`
  - added the new `ai_instance_not_configured` enum value to the `code` response property for the response status `429`
  - added the new `ai_instance_not_configured` enum value to the `code` response property for the response status `500`
  - added the new `ai_smart_tools_disabled` enum value to the `code` response property for the response status `400`
  - added the new `ai_smart_tools_disabled` enum value to the `code` response property for the response status `401`
  - added the new `ai_smart_tools_disabled` enum value to the `code` response property for the response status `403`
  - added the new `ai_smart_tools_disabled` enum value to the `code` response property for the response status `429`
  - added the new `ai_smart_tools_disabled` enum value to the `code` response property for the response status `500`
  - added the new `bad_gateway` enum value to the `code` response property for the response status `400`
  - added the new `bad_gateway` enum value to the `code` response property for the response status `401`
  - added the new `bad_gateway` enum value to the `code` response property for the response status `403`
  - added the new `bad_gateway` enum value to the `code` response property for the response status `429`
  - added the new `bad_gateway` enum value to the `code` response property for the response status `500`
  - added the new `unprocessable_content` enum value to the `code` response property for the response status `400`
  - added the new `unprocessable_content` enum value to the `code` response property for the response status `401`
  - added the new `unprocessable_content` enum value to the `code` response property for the response status `403`
  - added the new `unprocessable_content` enum value to the `code` response property for the response status `429`
  - added the new `unprocessable_content` enum value to the `code` response property for the response status `500`
- **2026-05-28** `b514d6392200` — 35 info
  - added the optional property `invalid_params/items/code` to the response with the `400` status
  - added the optional property `invalid_params/items/code` to the response with the `401` status
  - added the optional property `invalid_params/items/code` to the response with the `403` status
  - added the optional property `invalid_params/items/code` to the response with the `429` status
  - added the optional property `invalid_params/items/code` to the response with the `500` status
  - added the optional property `invalid_params/items/conflictsWith` to the response with the `400` status
  - added the optional property `invalid_params/items/conflictsWith` to the response with the `401` status
  - added the optional property `invalid_params/items/conflictsWith` to the response with the `403` status
  - added the optional property `invalid_params/items/conflictsWith` to the response with the `429` status
  - added the optional property `invalid_params/items/conflictsWith` to the response with the `500` status
  - added the optional property `invalid_params/items/firstUsedAt` to the response with the `400` status
  - added the optional property `invalid_params/items/firstUsedAt` to the response with the `401` status
  - added the optional property `invalid_params/items/firstUsedAt` to the response with the `403` status
  - added the optional property `invalid_params/items/firstUsedAt` to the response with the `429` status
  - added the optional property `invalid_params/items/firstUsedAt` to the response with the `500` status
  - added the optional property `invalid_params/items/missingId` to the response with the `400` status
  - added the optional property `invalid_params/items/missingId` to the response with the `401` status
  - added the optional property `invalid_params/items/missingId` to the response with the `403` status
  - added the optional property `invalid_params/items/missingId` to the response with the `429` status
  - added the optional property `invalid_params/items/missingId` to the response with the `500` status
  - added the optional property `invalid_params/items/referenceType` to the response with the `400` status
  - added the optional property `invalid_params/items/referenceType` to the response with the `401` status
  - added the optional property `invalid_params/items/referenceType` to the response with the `403` status
  - added the optional property `invalid_params/items/referenceType` to the response with the `429` status
  - added the optional property `invalid_params/items/referenceType` to the response with the `500` status
  - the response property `invalid_params/items/name` became required for the status `400`
  - the response property `invalid_params/items/name` became required for the status `401`
  - the response property `invalid_params/items/name` became required for the status `403`
  - the response property `invalid_params/items/name` became required for the status `429`
  - the response property `invalid_params/items/name` became required for the status `500`
  - the response property `invalid_params/items/reason` became required for the status `400`
  - the response property `invalid_params/items/reason` became required for the status `401`
  - the response property `invalid_params/items/reason` became required for the status `403`
  - the response property `invalid_params/items/reason` became required for the status `429`
  - the response property `invalid_params/items/reason` became required for the status `500`
- **2026-05-28** `23ec9fd15a38` — 1 breaking, 6 info
  - removed the success response with the status `200`
  - added the optional property `invalid_params/items/identifier` to the response with the `400` status
  - added the optional property `invalid_params/items/identifier` to the response with the `401` status
  - added the optional property `invalid_params/items/identifier` to the response with the `403` status
  - added the optional property `invalid_params/items/identifier` to the response with the `429` status
  - added the optional property `invalid_params/items/identifier` to the response with the `500` status
  - added the success response with the status `204`
- **2026-04-17** `6e736eb7b23c` — 1 info
  - endpoint added
- **2026-03-20** `9fa9931e1a70` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/formbricks/apis/formbricks-api-v3/docs/api/v3/surveys/:surveyId/delete.md) · [API](https://skmtc.dev/formbricks/apis/formbricks-api-v3.md) · [Page](https://skmtc.dev/formbricks/apis/formbricks-api-v3/changes/api/v3/surveys/:surveyId/delete)
