> ## Documentation Index
> Fetch the complete documentation index at: https://openwearables.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Put Personal Record

> 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.



## OpenAPI

````yaml /openapi.json put /api/v1/users/{user_id}/personal-record
openapi: 3.1.0
info:
  title: Open Wearables API
  version: 0.9.0
servers: []
security: []
paths:
  /api/v1/users/{user_id}/personal-record:
    put:
      tags:
        - 'External: Users'
      summary: Put Personal Record
      description: >-
        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.
      operationId: put_personal_record_api_v1_users__user_id__personal_record_put
      parameters:
        - name: user_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: User Id
        - name: X-Open-Wearables-API-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Open-Wearables-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PersonalRecordUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonalRecordResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - OAuth2PasswordBearer: []
components:
  schemas:
    PersonalRecordUpdate:
      properties:
        birth_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Birth Date
          description: Birth date of the user
        gender:
          anyOf:
            - type: string
              enum:
                - female
                - male
                - nonbinary
                - other
            - type: 'null'
          title: Gender
          description: Optional self-reported gender
        sex:
          anyOf:
            - type: string
              enum:
                - female
                - male
            - type: 'null'
          title: Sex
          description: Biological sex, for norms that differ between women and men
      type: object
      title: PersonalRecordUpdate
      description: 'The whole record: a field left out is stored as null.'
    PersonalRecordResponse:
      properties:
        birth_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Birth Date
          description: Birth date of the user
        gender:
          anyOf:
            - type: string
              enum:
                - female
                - male
                - nonbinary
                - other
            - type: 'null'
          title: Gender
          description: Optional self-reported gender
        user_id:
          type: string
          format: uuid
          title: User Id
        sex:
          anyOf:
            - type: string
              enum:
                - female
                - male
            - type: 'null'
          title: Sex
          description: Biological sex, for norms that differ between women and men
      type: object
      required:
        - user_id
      title: PersonalRecordResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: /api/v1/auth/login

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.