---
title: "Create or replace a weight measurement for a date"
method: POST
path: "/v1/weights"
tags: ["weights"]
---

# Create or replace a weight measurement for a date

`POST /v1/weights`

## Request

- Base URL: `http://localhost:4318`
- URL: `http://localhost:4318/v1/weights`
- Auth: HTTP bearer

## Request body

- object
  - `date` string, required
  - `kg` number, required
  - `note` string

## Response `201`

Success

- Weight
  - `id` string
  - `date` string, date
  - `kg` number
  - `note` string
  - `revision` integer
  - `healthSampleId` string, uuid, nullable
  - `measuredAt` string, date-time, nullable

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid bearer token
- `409`: Revision or idempotency conflict
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nibb/apis/nibb-api.md) · [All operations](https://skmtc.dev/nibb/apis/nibb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nibb/apis/nibb-api/revisions/75bcd8b761ed?raw)