---
title: "Update a user field"
method: PATCH
path: "/users/v1/fields/{id}"
tags: ["Users"]
---

# Update a user field

`PATCH /users/v1/fields/{id}`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/users/v1/fields/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- S12UsersUserfieldV1UserFieldServiceUpdateFieldBody
  - `name` string: Attribute name
  - `description` string: The attribute description
  - `select_options` S12TypefieldV1FieldOption[]: Field select options
    - `id` string: The id of a field select option.
    - `label` string: The label of a field select option.
    - `order` integer: The display order of this option, 0-indexed. Options should be displayed in ascending order of this field, matching the order they were defined in the field settings.
  - `update_mask` string: Required. The attributes (such as name etc.) you want to update for the field, specified in the parameters. For example, the update_mask=name parameter indicates that only the name will be updated in a request, any other attributes provided in your request body will be ignored.

## Response `200`

A successful response.

- S12UsersUserfieldV1UpdateFieldResponse
  - `field` S12UsersUserfieldV1Field
    - `id` string: Required. The field UUID
    - `data_type` 'FIELD_VALUE_TYPE_UNSPECIFIED' | 'FIELD_VALUE_TYPE_STRING' | 'FIELD_VALUE_TYPE_MONEY' | 'FIELD_VALUE_TYPE_TIMESTAMP' | 'FIELD_VALUE_TYPE_USER_ID' | 'FIELD_VALUE_TYPE_SELECT' | 'FIELD_VALUE_TYPE_TEMPLATE_ID' | 'FIELD_VALUE_TYPE_MULTI_SELECT' | 'FIELD_VALUE_TYPE_SITE' | 'FIELD_VALUE_TYPE_MULTI_SITE' | 'FIELD_VALUE_TYPE_INTEGER' | 'FIELD_VALUE_TYPE_ADDRESS' | 'FIELD_VALUE_TYPE_TIMEZONE' | 'FIELD_VALUE_TYPE_CONTACT_DETAILS': Type of FieldValue. Defaults to type String. - FIELD_VALUE_TYPE_UNSPECIFIED: Field value type unspecified. - FIELD_VALUE_TYPE_STRING: Field value type string. - FIELD_VALUE_TYPE_MONEY: Field value type money. - FIELD_VALUE_TYPE_TIMESTAMP: Field value type timestamp. - FIELD_VALUE_TYPE_USER_ID: Field value type user ID. - FIELD_VALUE_TYPE_SELECT: Field value type select - FIELD_VALUE_TYPE_TEMPLATE_ID: Field value type template ID. - FIELD_VALUE_TYPE_MULTI_SELECT: Field value type multi-select - FIELD_VALUE_TYPE_SITE: Field value type site - FIELD_VALUE_TYPE_MULTI_SITE: Field value type multi-site - FIELD_VALUE_TYPE_INTEGER: Field value type integer - FIELD_VALUE_TYPE_ADDRESS: Field value type address. - FIELD_VALUE_TYPE_TIMEZONE: Field value type timezone - FIELD_VALUE_TYPE_CONTACT_DETAILS: Field value type contact details
    - `name` string: Required. The attribute name
    - `description` string: The attribute description
    - `has_attributes` boolean: Required. Flag to specify if the field has associated populated attributes
    - `status` 'FIELD_STATUS_UNSPECIFIED' | 'FIELD_STATUS_ENABLED' | 'FIELD_STATUS_DISABLED'
    - `settings` S12UsersUserfieldV1FieldSettings
      - `show_on_profile` boolean: Required. Flag to specify if the attribute is visible/configurable on the user profile
      - `allow_self_update` boolean: Required. Flag to specify if all users can update the attribute for their own account
      - `read_only` boolean: Read only. True when the field is system-managed and cannot be edited by users: allow_self_update is locked off and clients should render its toggle as disabled. Derived server-side from the set of read-only fields; ignored on write.
    - `category` 'FIELD_CATEGORY_UNSPECIFIED' | 'FIELD_CATEGORY_SYSTEM_FIELD' | 'FIELD_CATEGORY_CUSTOM_FIELD': - FIELD_CATEGORY_UNSPECIFIED: Field category Unspecified. - FIELD_CATEGORY_SYSTEM_FIELD: Field category pre-defined. - FIELD_CATEGORY_CUSTOM_FIELD: Field category custom.
    - `select_options` S12TypefieldV1FieldOption[]: Field select options
      - `id` string: The id of a field select option.
      - `label` string: The label of a field select option.
      - `order` integer: The display order of this option, 0-indexed. Options should be displayed in ascending order of this field, matching the order they were defined in the field settings.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
