> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a Form

> Updates an existing form by its ID.

import { ParamField } from "/snippets/param-field.mdx";

### PUT /v1/forms/:id

Updates the details of a specific form by its unique ID.

#### Path Parameters

<ParamField name="id" type="string" required>
  The ID of the form to update.
</ParamField>

#### Body Parameters

<ParamField name="name" type="string">
  The internal name of the form.
</ParamField>

<ParamField name="slug" type="string">
  A unique slug for the form.
</ParamField>

<ParamField name="title" type="string">
  The public title of the form.
</ParamField>

<ParamField name="description" type="string">
  A description of the form.
</ParamField>

<ParamField name="status" type="string">
  The status of the form. Can be `draft` or `published`.
</ParamField>

<ParamField name="fields" type="array">
  An array of field objects that define the structure of the form.
</ParamField>

<ParamField name="settings" type="object">
  An object containing settings for the form, such as success messages and redirect URLs.
</ParamField>

<ParamField name="notification_emails" type="array">
  A list of email addresses to notify upon new submissions.
</ParamField>

#### Example Request

```bash theme={null}
curl -X PUT "https://api.example.com/v1/forms/form_123" \
     -H "Authorization: Bearer <YOUR_API_KEY>" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "Updated Contact Form Title"
     }'
```

#### Example Response

```json theme={null}
{
  "id": "form_123",
  "name": "Contact Form",
  "slug": "contact-form",
  "title": "Updated Contact Form Title",
  "description": "A simple contact form.",
  "status": "published",
  "fields": [
    { "id": "name", "type": "text", "label": "Name", "required": true },
    { "id": "email", "type": "email", "label": "Email", "required": true }
  ],
  "settings": null,
  "notification_emails": [],
  "created_by": "user_456",
  "created_at": "2023-01-01T00:00:00.000Z",
  "updated_at": "2023-01-02T00:00:00.000Z"
}
```