Delete a response
Deletes one response for good, for a person who asks to be forgotten, or for spam.
Free
This tool costs nothing to call.
An example
Hannah Price asked us to forget her. Delete her repair survey answer.
Your agent callsforms_delete_responseFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"response_id": "2f8b6d4a-0c9e-4b7d-8a1c-3e5f7b9d0a2c"
}Use it when
One response must go; exported CSV files keep their copy until they are deleted too.
What it does
Delete one response for good, for a person who asks to be forgotten or for spam. Exported CSV files keep their copy until you delete them too.
What comes back
deleted: the response_id. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
response_idRequired | string | 32 to 36 characters. |
The call
Over MCP, call forms_delete_response on https://api.conecto.chat/mcp/forms. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/forms_delete_response \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"response_id":"2f8b6d4a-0c9e-4b7d-8a1c-3e5f7b9d0a2c"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No response of the business has that response_id. | Find it with forms_list_responses and use its response_id. |
More Forms tools
All 12 tools- Create a form
forms_createCreates a form or survey with its own public page that anyone can open and answer.$0.01 a call - Change a form
forms_updateChanges a form's fields or settings; only what you pass changes.$0.01 a call - Get a form
forms_getOne form with its fields, settings, public link, whether it takes responses (and why not) and its response count.Free* - List forms
forms_listThe business's forms, newest first, with their links, whether each takes responses, and their response counts.Free* - List responses
forms_list_responsesA form's responses, newest first, each answer with its question and a readable value.Free* - Get a response
forms_get_responseOne response by its response_id, with every answer readable.Free* - Summarize responses
forms_summaryA form's results at a glance: choice counts, rating averages, the NPS score, yes and no shares, numbers and the latest text answers.Free* - Export responses to CSV
forms_export_responsesSaves a CSV of a form's responses in the file store and returns a download link.$0.001 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md