---
title: "Create feature"
method: POST
path: "/v1/features"
tags: ["Features"]
---

# Create feature

`POST /v1/features`

Create a feature definition.

## Request body

- union
  - object
    - `code` string, required — Feature code.
    - `name` string, required — Feature name.
    - `description` string, nullable — Feature description.
    - `value_type` 'boolean', required — Type of feature value.
    - `default_value` boolean, nullable, required — Default value used when no product or customer feature value applies. Null means no default.
  - object
    - `code` string, required — Feature code.
    - `name` string, required — Feature name.
    - `description` string, nullable — Feature description.
    - `value_type` 'number', required — Type of feature value.
    - `resolution_strategy` 'max' | 'sum' | 'replace', required — Strategy used to combine multiple product feature values for number features.
    - `default_value` number, nullable, required — Default value used when no product or customer feature value applies. Null means no default.

## Response `201`

- Feature
  - `code` string, required — Feature code.
  - `name` string, required — Feature name.
  - `description` string, nullable, required — Feature description.
  - `value_type` 'boolean' | 'number', required — Type of feature value.
  - `resolution_strategy` 'max' | 'sum' | 'replace', nullable, required — Strategy used to combine multiple product feature values for number features.
  - `default_value` union, required — Default value used when no product or customer feature value applies. Null means no default.
    - boolean
    - number
  - `status` 'active' | 'archived', required — Feature status.
  - `created_at` string, date-time, required — Creation date.
  - `updated_at` string, date-time, required — Last update date.
  - `archived_at` string, date-time, nullable, required — Archival date.

---

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