---
title: "Create Feature"
method: POST
path: "/api/v3/admin/features"
tags: ["admin", "features"]
---

# Create Feature

`POST /api/v3/admin/features`

## Request

- Base URL: `https://api.endless.health` (the document declares no server; this is the origin it was published from)
- URL: `https://api.endless.health/api/v3/admin/features`
- Auth: none declared

Create a new feature definition.

Note: Features should typically be defined in code (feature_constants.py)
and seeded via CLI. This endpoint is for exceptional cases.

## Request body

- FeatureCreateSchema: Schema for creating a new feature definition
  - `key` string, required
  - `name` string, required
  - `type` 'RELEASE_FLAG' | 'ENTITLEMENT', required: Feature type enum - defines whether feature is a release flag or entitlement
  - `default_enabled` boolean, required
  - `config_schema` object, nullable
  - `default_config` object, nullable

## Response `201`

Successful Response

- FeatureSchema: Schema for feature definition
  - `id` integer, required
  - `key` string, required
  - `name` string, required
  - `type` 'RELEASE_FLAG' | 'ENTITLEMENT', required: Feature type enum - defines whether feature is a release flag or entitlement
  - `default_enabled` boolean, required
  - `config_schema` object, nullable
  - `default_config` object, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/endless/apis/eh-core-v3-api-prod.md) - [All operations](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/llms.txt) - [OpenAPI document](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/revisions/9046a1eb2d0c?raw)