---
title: "Create a license field for a given app."
method: POST
path: "/app/{app_id}/license-field"
tags: ["apps"]
---

# Create a license field for a given app.

`POST /app/{app_id}/license-field`

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

## Path parameters

- `app_id` string, required

## Request body

- object
  - `default` string — Default value of the entitlement field that is to be created.
  - `hidden` boolean, required — Hidden flag of the entitlement field that is to be created.
  - `name` string, required — Name of the entitlement field that is to be created.
  - `required` boolean — Required flag of the entitlement field that is to be created.
  - `title` string, required — Title of the entitlement field that is to be created.
  - `type` string, required — Type of the entitlement field that is to be created.

## Response `200`

CreateLicenseFieldResponse contains the response of all license fields

- EntitlementField
  - `default` 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

---

[API](https://skmtc.net/replicated/apis/vendor-api-v3-2.md) · [All operations](https://skmtc.net/replicated/apis/vendor-api-v3-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicated/vendor-api-v3-2/versions/6fcf9e54aba4/schema)