---
title: "Submit a care team challenge points event"
method: POST
path: "/patients/{patient_id}/care-team-challenges/points/events"
tags: ["careteam"]
---

# Submit a care team challenge points event

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

## Path parameters

- `patient_id` integer, required

## Request body

- CreatePatientCareTeamChallengePointsEventRequest
  - `challenge_id` 'thirty-plant-challenge' — Required for plant events. Must be thirty-plant-challenge.
  - `challenge_run_id` string — Required for plant events.
  - `event_type` 'QUIZ_COMPLETED' | 'TASK_COMPLETED' | 'TASK_UNCHECKED' | 'PLANT_LOGGED' | 'PLANT_UNLOGGED', required
  - `idempotency_key` string, required — For plant events, must be canonical: thirty-plant-challenge:{challenge_run_id}:plant:{plant_source}:{url_encoded_plant_key}:{logged|unlogged}:{client_event_id}.
  - `plant_key` string — Required for plant events. Canonicalized by mobile.
  - `plant_source` 'manual' | 'meal_auto' — Required for plant events.
  - `points_date` string, date — Optional for plant events. Defaults to patient local date.

## Response `200`

successful operation

- PatientCareTeamChallengePointsEventResponse
  - `accepted` boolean, required
  - `delta_points` integer, required
  - `outcome` 'applied' | 'reversed' | 'no_op_duplicate' | 'no_op_cap_reached' | 'no_op_no_reversible_award', required
  - `retired` boolean — Additive marker that legacy points are retired for this patient.
  - `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/events/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/081a2697c0f1?raw)
