Forms
Close a form
Stops a form taking responses; its page then says it is closed.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Stop taking entries for the autumn raffle. It's over.
Your agent callsforms_close$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.
With these arguments
{
"form": "autumn-raffle"
}What comes back
Use it when
A raffle, a survey or an application round is over.
What it does
Stop a form taking responses; its page then says it is closed. forms_open reopens it.
What comes back
The form with its new status. 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_close on https://api.conecto.chat/mcp/forms. Over REST:
Terminal
curl -X POST https://api.conecto.chat/v1/tools/forms_close \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"form":"autumn-raffle"}'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