---
title: "Apply a reviewed recommendation with revision checks and safe retries"
method: POST
path: "/v1/nutrition/apply"
tags: ["nutrition"]
---

# Apply a reviewed recommendation with revision checks and safe retries

`POST /v1/nutrition/apply`

## Request

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

## Request body

- object
  - `profile` object, required
    - `weightUnit` 'kg' | 'lb'
    - `gender` string: Optional self-described gender; never substitutes for the equation coefficient.
    - `aspirations` string
    - `age` integer
    - `weightKg` number
    - `heightCm` number
    - `equationSex` 'male' | 'female': Coefficient from the original resting-energy equation; ask, never infer from name. May be omitted with established maintenance calories.
    - `activityFactor` number: Whole-day activity multiplier including exercise. NIDDK typical range 1.4 sedentary to 2.5 very active; this remains an estimate.
    - `knownMaintenanceKcal` number
    - `maintenanceEvidence` string: How maintenance was established. Never infer it from partially logged intake.
    - `goal` 'maintain' | 'lose_fat' | 'gain_muscle'
    - `training` 'none' | 'endurance' | 'resistance' | 'mixed'
    - `pregnantOrBreastfeeding` boolean
    - `requiresClinicalDiet` boolean: A condition or medication requiring individualized nutrition, e.g. kidney disease or glucose-lowering treatment.
    - `eatingDisorderHistory` boolean
    - `pace` 'gentle' | 'moderate'
    - `dietPreference` 'flexible' | 'mediterranean' | 'vegetarian' | 'vegan'
    - `macroPreference` 'balanced' | 'more_carbs' | 'more_fat'
    - `proteinGPerKg` number
    - `targetWeightKg` number
  - `proposalId` string, required
  - `expectedRevision` integer, required
  - `idempotencyKey` string, required

## Response `200`

Success

- object

## 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)