---
title: "Update Field"
method: PUT
path: "/fields/{field_id}"
tags: ["Custom Fields"]
---

# Update Field

`PUT /fields/{field_id}`

Update a custom field's name, type-specific options, or visibility.

## Path parameters

- `field_id` number, required

## Request body

- FieldRequestUpdateRequest
  - `name` string
  - `type` 'number' | 'text' | 'select' | 'date'
  - `format` FieldFormat
    - `format` 'number' | 'currency' | 'percent' | 'label'
    - `type` 'date' | 'dob' — Optional type for date field
    - `decimals` number
    - `label` string — Label up to 8 symbols
    - `labelAt` 'left' | 'right' — Label position left/right
  - `icon` string
  - `options` FieldOption[] — Up to 10 options, required when `type` is `select`.
    - `id` number
    - `name` string
    - `color` string

## Response `200`

OK

- Field
  - `id` number — Custom field ID
  - `name` string
  - `type` string
  - `format` FieldFormat
    - `format` 'number' | 'currency' | 'percent' | 'label'
    - `type` 'date' | 'dob' — Optional type for date field
    - `decimals` number
    - `label` string — Label up to 8 symbols
    - `labelAt` 'left' | 'right' — Label position left/right
  - `options` FieldOption[]
    - `id` number
    - `name` string
    - `color` string
  - `position` number
  - `icon` string — Field icon name

## Other responses

- `401` — Unauthorized

---

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