Skip to content

Update a feature's name, description, default or enum options

PATCH
/v1/features/{feature_key}
curl --request PATCH \
--url https://api.seal0.app/v1/features/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "add_enum_options": [ "example" ], "default_value": true, "description": "example", "grace_percent": 1, "name": "example" }'

Merge semantics. Absent fields are unchanged; null clears a nullable field.

feature_key
required
string
Idempotency-Key
string
>= 1 characters <= 255 characters

Optional; replays the stored response for 24 hours.

Media typeapplication/json
object
add_enum_options
Array<string>
default_value
One of:
boolean
description
string
nullable <= 2000 characters
grace_percent

Metered features only: how far usage may exceed the limit before the feature is no longer granted. 0 is a hard limit. Only metered features accept a non-zero value.

integer
<= 100
name
string
>= 1 characters <= 200 characters

Example generated

{
"add_enum_options": [
"example"
],
"default_value": true,
"description": "example",
"grace_percent": 1,
"name": "example"
}

The updated feature.

Media typeapplication/json
object
created_at
required
string format: date-time
default_value
required
One of:
boolean
description
required
string
nullable
enum_options
required
Array<string>
nullable
grace_percent
required

Metered features only: how far usage may exceed the limit before the feature is no longer granted. 0 is a hard limit. Always 0 for other types.

integer
<= 100
id
required
string
key
required

Feature or plan key.

string
/^[a-z][a-z0-9_]{0,63}$/
name
required
string
updated_at
required
string format: date-time
value_type
required
string

Example generated

{
"created_at": "2026-04-15T12:00:00Z",
"default_value": true,
"description": "example",
"enum_options": [
"example"
],
"grace_percent": 1,
"id": "example",
"key": "example",
"name": "example",
"updated_at": "2026-04-15T12:00:00Z",
"value_type": "example"
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}