Skip to content

Add a customer-specific value

POST
/v1/customers/{external_customer_id}/overrides
curl --request POST \
--url https://api.seal0.app/v1/customers/example/overrides \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "expires_at": "2026-04-15T12:00:00Z", "feature_key": "example", "starts_at": "2026-04-15T12:00:00Z", "value": true }'
external_customer_id
required
string

Opaque customer ID; must match ^[A-Za-z0-9._:-]{1,255}$.

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

Optional; replays the stored response for 24 hours.

Media typeapplication/json
object
expires_at
string format: date-time
feature_key
required
string
starts_at

Defaults to now.

string format: date-time
value
required
One of:
boolean

Example generated

{
"expires_at": "2026-04-15T12:00:00Z",
"feature_key": "example",
"starts_at": "2026-04-15T12:00:00Z",
"value": true
}

The created override.

Media typeapplication/json
object
created_at
required
string format: date-time
customer_id
required

The customer’s external ID.

string
expires_at
required
string format: date-time
nullable
feature_key
required

Feature or plan key.

string
/^[a-z][a-z0-9_]{0,63}$/
id
required
string
revoked_at
required
string format: date-time
nullable
starts_at
required
string format: date-time
value
required
One of:
boolean

Example generated

{
"created_at": "2026-04-15T12:00:00Z",
"customer_id": "example",
"expires_at": "2026-04-15T12:00:00Z",
"feature_key": "example",
"id": "example",
"revoked_at": "2026-04-15T12:00:00Z",
"starts_at": "2026-04-15T12:00:00Z",
"value": true
}

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"
}
}

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"
}
}