update_form

Update form configuration. Only provide the fields you want to change.

Parameters

Name Type Required Validation Description
formId string Yes -- Form ID (UUID)
name string No Min 2, max 120 chars New form display name
allowedOrigins string[] No -- New allowed origins list (replaces existing)
isEnabled boolean No -- Enable or disable the form

Response Example

Form a1b2c3d4-... updated successfully.

If no fields are provided:

No updates provided.

Error Cases

Error Cause
Form not found. Invalid form ID or form belongs to a different organization
No updates provided. Called without any optional fields
401 Unauthorized Invalid or expired secret key
Zod validation error name too short or too long

Example Prompt

"Disable my contact form and restrict it to only accept submissions from https://newsite.com."

TIP

CLI equivalent: npx formdata-dev forms update <formId> (interactive with defaults pre-filled).