---
title: "PATCH /api/field-permissions/{field_id}/"
method: PATCH
path: "/api/field-permissions/{field_id}/"
tags: ["Field permissions"]
---

# PATCH /api/field-permissions/{field_id}/

`PATCH /api/field-permissions/{field_id}/`

Update permissions for writing field values and form visibility for a specific field. This endpoint is used to restrict the ability to modify field values to the roles defined. It also makes it possible to decide if the field can be exposed in forms or not.

This is a **enterprise** feature.

## Path parameters

- `field_id` integer, required

## Request body

- PatchedUpdateFieldPermissionsRequest
  - `role` 'ADMIN' | 'BUILDER' | 'EDITOR' | 'NOBODY' — * `ADMIN` - Admin * `BUILDER` - Builder * `EDITOR` - Editor * `NOBODY` - Nobody
  - `allow_in_forms` boolean — Whether to allow this field to be shown in forms. Default is False. This setting is only relevant if the role is not 'EDITOR'.

## Response `200`

- UpdateFieldPermissionsResponse
  - `role` 'ADMIN' | 'BUILDER' | 'EDITOR' | 'NOBODY', required — * `ADMIN` - Admin * `BUILDER` - Builder * `EDITOR` - Editor * `NOBODY` - Nobody
  - `allow_in_forms` boolean — Whether to allow this field to be shown in forms. Default is False. This setting is only relevant if the role is not 'EDITOR'.
  - `field_id` integer, required — The ID of the field whose permissions were updated.
  - `can_write_values` boolean — Whether the user can write values to this field.

## Other responses

- `400`
- `404`

---

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