Skip to content
Sesharo Docs

Set Metric Range

PUT
/users/{user_id}/summary-card/metrics/{slug}
curl --request PUT \
  --url https://example.com/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/summary-card/metrics/example \
  --header 'Content-Type: application/json' \
  --data '{ "high": 1, "low": 1, "mode": "learned", "promote": true }'

Set one metric’s normal range (learned vs manual bounds) + promote toggle.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
user_id
required
User Id
string format: uuid
slug
required
Slug
string

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
SummaryMetricRangeUpdate

Set a metric’s normal range: learned (self-updating) or a manual low/high, plus whether it may be promoted to the amber band when out of range.

object
high
Any of:
number
low
Any of:
number
mode
Mode
string
default: learned
promote
Promote
boolean
default: true

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
SummaryMetricRead

One metric as the “Today so far” card needs it — everything but the live value, which the frontend already has from the /today fetch (read from value_field, or metrics[slug] when that’s null).

object
baseline_ready
required
Baseline Ready
boolean
high
required
Any of:
number
label
required
Label
string
learned_high
required
Any of:
number
learned_low
required
Any of:
number
low
required
Any of:
number
manual_high
required
Any of:
number
manual_low
required
Any of:
number
mode
required
Mode
string
position
required
Any of:
integer
promote
required
Promote
boolean
sample_days
required
Sample Days
integer
slug
required
Slug
string
source
required
Source
string
unit
required
Unit
string
value_field
required
Any of:
string
Examplegenerated
{
  "baseline_ready": true,
  "high": 1,
  "label": "example",
  "learned_high": 1,
  "learned_low": 1,
  "low": 1,
  "manual_high": 1,
  "manual_low": 1,
  "mode": "example",
  "position": 1,
  "promote": true,
  "sample_days": 1,
  "slug": "example",
  "source": "example",
  "unit": "example",
  "value_field": "example"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}