---
title: "Update a license field for a given appId and licenseFieldName."
method: PUT
path: "/app/{app_id}/license-field/{license_field_name}"
tags: ["apps"]
---

# Update a license field for a given appId and licenseFieldName.

`PUT /app/{app_id}/license-field/{license_field_name}`

## Request

- Base URL: `https://api.replicated.com/vendor/v3`
- URL: `https://api.replicated.com/vendor/v3/app/{app_id}/license-field/{license_field_name}`
- Auth: API key in header `Authorization`

Required RBAC Policy: kots/app/[:appid]/licensefields/update

## Path parameters

- `app_id` string, required
- `license_field_name` string, required

## Request body

- object
  - `default` string, required: Optional default value for this licensefield.
  - `enumOptions` string[]: Enum options for the entitlement field (only for Enum type).
  - `hidden` boolean, required: Indicates if this field will be visible from the on-premise license screen.
  - `required` boolean, required: Indicates if this field will be required from the on-premise license screen.
  - `title` string, required: Title of custom license field to display.

## Response `200`

EditLicenseFieldResponse contains the license fields

- EntitlementField
  - `default` string
  - `enumOptions` string[]
  - `hidden` boolean
  - `name` string
  - `required` boolean
  - `title` string
  - `type` string

## Other responses

- `400`: Returned on bad input
- `401`: Return if the caller is not authorized
- `403`: Returned if the caller does not have the needed permission
- `404`: Returned on resource not found

## Changes

- **2026-11-03** `a36c6aead22f`: 2 info
  - added the new optional request property `enumOptions`
  - added the optional property `enumOptions` to the response with the `200` status

[Operation history](https://skmtc.dev/replicated/apis/vendor-api-v3-2/changes/app/:app_id/license-field/:license_field_name/put.md)

---

[API](https://skmtc.dev/replicated/apis/vendor-api-v3-2.md) - [All operations](https://skmtc.dev/replicated/apis/vendor-api-v3-2/llms.txt) - [OpenAPI document](https://skmtc.dev/replicated/apis/vendor-api-v3-2/revisions/a36c6aead22f?raw)
