---
title: "PUT /forms/{slug_or_id}"
method: PUT
path: "/forms/{slug_or_id}"
tags: ["Forms"]
---

# PUT /forms/{slug_or_id}

`PUT /forms/{slug_or_id}`

This endpoint updates a specific form by slug or ID.
Please note that this feature is exclusively available as part of the [Business API](https://paperform.co/pricing/).

## Path parameters

- `slug_or_id` string, required

## Request body

- FormUpdate
  - `title` string, nullable — The title of the form.
  - `description` string, nullable — The description of the form.
  - `disabled` boolean — Whether the form is disabled.
  - `custom_slug` string, nullable — The custom slug of the form.
  - `space_id` string, nullable — The ID of the space to move the form into. Must be a valid space accessible to the user.
  - `translation_id` string, nullable — The ID of the translation to use on this form. Must be a valid translation accessible to the user. Setting to `null` will use the default account translation (English).

## Response `200`

Successfully updated a single form that matched the provided slug or ID

- object
  - `status` 'ok'
  - `results` object
    - `form` Form
      - `id` string, uuid — The unique identifier of the form.
      - `slug` string — The default generated slug for the form.
      - `custom_slug` string, nullable — The custom slug for the form if set.
      - `space_id` integer — The id of the Space which contains the form.
      - `title` string, nullable — The title of the form.
      - `description` string, nullable — The description of the form.
      - `cover_image_url` string, uri, nullable — The cover image for the form.
      - `url` string, uri — The main sharing URL for the form.
      - `additional_urls` string[] — Additional URLs for the form
      - `live` boolean — Indicates if the form is currently accepting submissions.
      - `tags` string[], nullable — The tags assigned to the form.
      - `submission_count` integer — The number of submissions the form has received.
      - `created_at` string — A formatted date-time string in your account timezone indicating the time the form was created.
      - `updated_at` string — A formatted date-time string in your account timezone indicating the time the form was created.
      - `account_timezone` string — The configured timezone for your account.
      - `created_at_utc` string, date-time — A formatted date-time string in UTC indicating the time the form was created.
      - `updated_at_utc` string, date-time — A formatted date-time string in UTC indicating the time the form was created.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `403` — Not Permitted
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests
- `5XX` — Unexpected Error

---

[API](https://skmtc.net/paperform/apis/paperform-api.md) · [All operations](https://skmtc.net/paperform/apis/paperform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paperform/paperform-api/versions/dc1e62b7063d/schema)