---
title: "PATCH /custom-fields/{id}/select-options"
method: PATCH
path: "/custom-fields/{id}/select-options"
tags: ["custom-fields"]
---

# PATCH /custom-fields/{id}/select-options

`PATCH /custom-fields/{id}/select-options`

Update a custom field select option
Updates an option's slug, label, or AI description. Slug changes preserve existing values and migrate persisted filters.

**Rate limit:** 120 requests per minute

## Path parameters

- `id` string, required

## Query parameters

- `current_slug` string, required

## Request body

- UpdateCustomFieldSelectOptionRequestBody
  - `ai_description` string — A replacement AI description. Pass an empty string to clear it.
  - `label` string — A replacement display label.
  - `slug` string — A replacement API slug. Existing object values and persisted filters are migrated to this slug.

## Response `200`

- UpdateCustomFieldSelectOptionResponseBody
  - `data` CustomFieldDefinitionSelectOption
    - `ai_description` string — The AI description of the option. This is used to help the AI understand when to select this option.
    - `label` string — The label of the option.
    - `slug` string — The slug of the option.
  - `request_id` string — The request ID for tracking.

## Other responses

- `400` — The request was invalid or could not be completed.
- `403` — The authenticated caller or organization is not allowed to access this endpoint or operation.
- `404`
- `500` — An unexpected internal error occurred.

## Changes

- **2026-09-02** `cef2ab0dd800` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usepylon/apis/pylon-api/changes/custom-fields/:id/select-options/patch.md)

---

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