Delete a form
Deletes a form and all its responses for good; its link stops working.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Delete the old 2025 summer survey and its answers.
Your agent callsforms_delete$0.001 a call
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.
{
"form": "summer-survey-2025"
}Use it when
A form and its answers are no longer wanted. Exported files stay in the file store.
- For stopping new responses but keeping the answers, use
forms_close.
What it does
Delete a form and all its responses for good; its link stops working. Exported files stay in the file store.
What comes back
deleted: the form_id, with its slug and responses_deleted: how many responses went with it. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
formRequired | string | The form's form_id or slug (forms_list shows both). 1 to 60 characters. |
The call
Over MCP, call forms_delete on https://api.conecto.chat/mcp/forms. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/forms_delete \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"form":"summer-survey-2025"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No form of the business has that form_id or slug. | Call forms_list and use a form_id or slug from it. |
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