---
title: "Update a feature"
method: PATCH
path: "/api/v1/features/{id}"
tags: ["Features"]
---

# Update a feature

`PATCH /api/v1/features/{id}`

Updates an existing feature's properties such as display name, description, and configuration.

## Path parameters

- `id` string, required

## Headers

- `X-ACCOUNT-ID` string
- `X-ENVIRONMENT-ID` string

## Request body

- UpdateFeatureRequestDto — Partially update an existing feature. Only provided fields are updated.
  - `displayName` string — The display name for the feature
  - `description` string — The description for the feature
  - `featureUnits` string — The units for the feature
  - `featureUnitsPlural` string — The plural units for the feature
  - `metadata` object — The additional metadata for the feature
  - `unitTransformation` object, nullable — Unit transformation to be applied to the reported usage
    - `divide` integer, required — Divide usage by this number
    - `round` 'UP' | 'DOWN' — After division, either round the result up or down
    - `featureUnits` string — Singular feature units after the transformation
    - `featureUnitsPlural` string — Plural feature units after the transformation
  - `enumConfiguration` object[] — The configuration data for the feature
    - `value` string, required — The unique value identifier for the enum configuration entity
    - `displayName` string, required — The display name for the enum configuration entity
  - `meter` object
    - `filters` object[], required
      - `conditions` object[], required
        - `operation` 'EQUALS' | 'NOT_EQUALS' | 'GREATER_THAN' | 'GREATER_THAN_OR_EQUAL' | 'LESS_THAN' | 'LESS_THAN_OR_EQUAL' | 'IS_NULL' | 'IS_NOT_NULL' | 'CONTAINS' | 'STARTS_WITH' | 'ENDS_WITH' | 'IN', required
        - `field` string, required — Condition field name
        - `value` string — Condition value
        - `values` string[]
    - `aggregation` object, required
      - `function` 'SUM' | 'MAX' | 'MIN' | 'AVG' | 'COUNT' | 'UNIQUE', required
      - `field` string — Aggregation field name

## Response `200`

The updated feature object.

- FeatureResponseDto — Response object
  - `data` object, required — Feature configuration object
    - `id` string, required — The unique identifier for the feature
    - `displayName` string, required — The display name for the feature
    - `description` string, nullable, required — The description for the feature
    - `featureType` 'BOOLEAN' | 'NUMBER' | 'ENUM', required — The type of the feature
    - `meterType` 'None' | 'FLUCTUATING' | 'INCREMENTAL', required — The meter type for the feature
    - `featureUnits` string, nullable, required — The units for the feature
    - `featureUnitsPlural` string, nullable, required — The plural units for the feature
    - `featureStatus` 'NEW' | 'SUSPENDED' | 'ACTIVE', required — The status of the feature
    - `unitTransformation` object, nullable, required — Unit transformation to be applied to the reported usage
      - `divide` number, required — Divide usage by this number
      - `round` 'UP' | 'DOWN', required — After division, either round the result up or down
      - `featureUnits` string, nullable, required — Singular feature units after the transformation
      - `featureUnitsPlural` string, nullable, required — Plural feature units after the transformation
    - `enumConfiguration` object[], nullable, required — The configuration data for the feature
      - `value` string, required — The unique value identifier for the enum configuration entity
      - `displayName` string, required — The display name for the enum configuration entity
    - `metadata` object, required — The additional metadata for the feature
    - `createdAt` string, date-time, required — Timestamp of when the record was created
    - `updatedAt` string, date-time, required — Timestamp of when the record was last updated

## Other responses

- `400` — bad request.
- `401` — User is not authenticated.
- `403` — User is not allowed to access this resource.
- `404` — Feature not found.
- `429` — Too many requests.

---

[API](https://skmtc.net/stiggio/apis/stigg-api.md) · [All operations](https://skmtc.net/stiggio/apis/stigg-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stiggio/stigg-api/versions/ffc977f1c07e/schema)