---
search:
  tags:
    - Measurements
    - POST
seo:
  description: >-
    Stores a body-part circumference measurement for the caller. Reference for
    the POST /api/measurements endpoint in the skcal API.
sidebar:
  label: Record a measurement
  badge: POST
title: Record a measurement
type: openapi-operation
---
Stores a body-part circumference measurement for the caller.

`POST /api/measurements`

**Request body** (`application/json`, required)

The measurement to record.

- `site` (string, required) — Body site identifier for the new measurement.
- `valueCm` (number, required) — Circumference to record, in centimetres.

Request body example:

```json
{
  "site": "waist",
  "valueCm": 81.5
}
```

**Responses**

- `200` — The measurement was stored.
- `400` — The request body or parameters failed validation.

Response example, 200:

```json
{
  "ok": true
}
```
