Update form access
Close a form, set open and expiration dates, a submission limit or a closed message.
PATCH https://cotlet.dev/api/v1/fillout/forms/{form_id}/access
write Confirm
Changes the Access settings of one form: Close form, Form open date, Form expiration date, Form submission limit and Custom form closed message. Only the fields you pass change; pass null to clear one. Closing a form stops new submissions at once, so respondents see the closed message. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| form_id string required | string | Form ID from list_forms. |
| closed boolean | boolean | true closes the form now, false reopens it. |
| open_date datetime | datetime | When the form starts accepting responses. |
| expiration_date datetime | datetime | When the form stops accepting responses. |
| submission_limit integer | integer | Close the form after this many responses. |
| closed_message string | string | Message shown when the form is closed. |
Request
curl -X PATCH https://cotlet.dev/api/v1/fillout/forms/tD6wNs3hLz8P/access \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"expiration_date":"2026-11-30T23:59:00+01:00","closed_message":"Registration is closed. See you next year."}'result = client.call("fillout", "update_form_access", {"form_id":"tD6wNs3hLz8P","expiration_date":"2026-11-30T23:59:00+01:00","closed_message":"Registration is closed. See you next year."})const result = await cotlet.call('fillout', 'update_form_access', {"form_id":"tD6wNs3hLz8P","expiration_date":"2026-11-30T23:59:00+01:00","closed_message":"Registration is closed. See you next year."});cotlet call fillout update_form_access --data '{"form_id":"tD6wNs3hLz8P","expiration_date":"2026-11-30T23:59:00+01:00","closed_message":"Registration is closed. See you next year."}'Example response
{
"form_id": "tD6wNs3hLz8P",
"access": {
"closed": false,
"open_date": null,
"expiration_date": "2026-11-30T23:59:00+01:00",
"submission_limit": null,
"closed_message": "Registration is closed. See you next year."
}
}