---
title: "Put Personal Record"
method: PUT
path: "/api/v1/users/{user_id}/personal-record"
tags: ["External: Users"]
---

# Put Personal Record

`PUT /api/v1/users/{user_id}/personal-record`

## Request

- Base URL: `https://api.openwearables.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openwearables.io/api/v1/users/{user_id}/personal-record`
- Auth: OAuth 2 (password, token URL `/api/v1/auth/login`)

Sets the user's birth date, gender and sex.

Replaces the whole record: a field left out of the body is set to null. Open Wearables uses
the birth date for the user's age, for example in the body summary and for the maximum heart
rate behind the intensity minutes of the activity summary.

## Path parameters

- `user_id` string, uuid, required

## Headers

- `X-Open-Wearables-API-Key` string, nullable

## Request body

- PersonalRecordUpdate: The whole record: a field left out is stored as null.
  - `birth_date` string, date, nullable: Birth date of the user
  - `gender` 'female' | 'male' | 'nonbinary' | 'other', nullable: Optional self-reported gender
  - `sex` 'female' | 'male', nullable: Biological sex, for norms that differ between women and men

## Response `200`

Successful Response

- PersonalRecordResponse
  - `birth_date` string, date, nullable: Birth date of the user
  - `gender` 'female' | 'male' | 'nonbinary' | 'other', nullable: Optional self-reported gender
  - `user_id` string, uuid, required
  - `sex` 'female' | 'male', nullable: Biological sex, for norms that differ between women and men

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-12** `f4aabbf4379f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openwearables/apis/open-wearables-api/changes/api/v1/users/:user_id/personal-record/put.md)

---

[API](https://skmtc.dev/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.dev/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openwearables/apis/open-wearables-api/revisions/c9016a165d04?raw)