---
title: "Update a single CustomField"
method: PATCH
path: "/custom_fields/{id}.json"
tags: ["Custom Fields"]
---

# Update a single CustomField

`PATCH /custom_fields/{id}.json`

Outlines the parameters and data fields used when updating a single CustomField

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string

## Headers

- `IF-MATCH` string
- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `display_order` integer — The display position of the CustomField.
    - `displayed` boolean — Whether or not the CustomField should be displayed by default.
    - `name` string — CustomField name.
    - `picklist_options` object[]
      - `id` integer — The unique identifier for a single PicklistOption associated with the CustomField. The keyword `null` is not valid for this field. Not required for creating new PicklistOptions, but required for updating or deleting existing ones.
      - `option` string — The option value.
      - `_deleted` boolean — Whether or not the PicklistOption should be deleted.
    - `required` boolean — Whether or not the CustomField should require a value.

## Response `200`

Ok

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

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