---
title: "Redeem care team challenge points"
method: POST
path: "/patients/{patient_id}/care-team-challenges/points/redeem"
tags: ["careteam"]
---

# Redeem care team challenge points

`POST /patients/{patient_id}/care-team-challenges/points/redeem`

## Path parameters

- `patient_id` integer, required

## Request body

- CreatePatientCareTeamChallengePointsRedeemRequest
  - `idempotency_key` string, required
  - `reward_type` 'dietitian_session' | 'microbiome_test' | 'vitamins_supplements' — Canonical reward type.

## Response `200`

successful operation

- PatientCareTeamChallengePointsRedeemResponse
  - `accepted` boolean, required
  - `delta_points` integer, required
  - `outcome` 'applied' | 'insufficient_points', required
  - `redemption_id` integer, nullable
  - `retired` boolean — Additive marker that legacy points are retired for this patient.
  - `reward_code` string, nullable
  - `reward_type` 'dietitian_session' | 'microbiome_test' | 'vitamins_supplements', required — Canonical reward type.
  - `total_points` integer, required

## Changes

- **2026-09-15** `8d4f658e79b1` — 1 info
  - added the optional property `retired` to the response with the `200` status

[Change history](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/changes/patients/:patient_id/care-team-challenges/points/redeem/post.md)

---

[API](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server.md) · [All operations](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/llms.txt) · [OpenAPI document](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/revisions/a61b77b30e63?raw)