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

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

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

Retrieve the permissions for writing field values and form visibility of a specific field.

This is a **enterprise** feature.

## Path parameters

- `field_id` integer, required

## Response `200`

- UpdateFieldPermissionsResponse
  - `role` 'ADMIN' | 'BUILDER' | 'EDITOR' | 'CUSTOM' | 'NOBODY', required — * `ADMIN` - Admin * `BUILDER` - Builder * `EDITOR` - Editor * `CUSTOM` - Custom * `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'.
  - `subjects` FieldPermissionSubjectResponse[], required
    - `subject_id` integer, required
    - `subject_type` 'auth.User' | 'anonymous' | 'user_source.user' | 'core.Token' | 'baserow_enterprise.Team', required — * `auth.User` - auth.User * `anonymous` - anonymous * `user_source.user` - user_source.user * `core.Token` - core.Token * `baserow_enterprise.Team` - baserow_enterprise.Team
  - `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`

## Changes

- **2026-08-27** `f3396317d932` — 1 warning, 1 info
  - added the new `CUSTOM` enum value to the `role/allOf[#/components/schemas/RoleEnum]/` response property for the response status `200`
  - added the required property `subjects` to the response with the `200` status

[Change history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/field-permissions/:field_id/get.md)

---

[API](https://skmtc.dev/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.dev/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/revisions/f3396317d932/schema)