---
title: "POST /mr-api/application/{id}/features"
method: POST
path: "/mr-api/application/{id}/features"
tags: ["FeatureService"]
---

# POST /mr-api/application/{id}/features

`POST /mr-api/application/{id}/features`

add a new feature to this application, returns all features.

## Request body

- Feature — exists simply to hold the name of the feature as it exists across all environments
  - `id` string, uuid
  - `key` string — Unique within this application
  - `alias` string — use this in code, as then people cannot guess your new features from their names
  - `link` string
  - `name` string, required — description if any
  - `valueType` 'BOOLEAN' | 'STRING' | 'NUMBER' | 'JSON'
  - `version` integer — used for optimistic locking when renaming a feature
  - `whenArchived` string, date-time
  - `secret` boolean — should the config remain invisible to users without secret permission
  - `description` string
  - `metaData` string — Metadata that may need to be stored. Intended for ADK use. No data limit (stored as CLOB)

## Response `200`

All features, alphabetically sorted

- Feature[]
  - `id` string, uuid
  - `key` string — Unique within this application
  - `alias` string — use this in code, as then people cannot guess your new features from their names
  - `link` string
  - `name` string, required — description if any
  - `valueType` 'BOOLEAN' | 'STRING' | 'NUMBER' | 'JSON'
  - `version` integer — used for optimistic locking when renaming a feature
  - `whenArchived` string, date-time
  - `secret` boolean — should the config remain invisible to users without secret permission
  - `description` string
  - `metaData` string — Metadata that may need to be stored. Intended for ADK use. No data limit (stored as CLOB)

## Other responses

- `400` — Bad Request
- `401` — no permission
- `409` — Duplicate feature

---

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