# KEYPOINTS (optional)

Real-time endpoint:

```
https://app.posetracker.com/pose_tracker/tracking?token=YOUR_API_KEY&keypoints=true
```

Upload endpoint:

```
https://app.posetracker.com/pose_tracker/upload_tracking?token=YOUR_API_KEY&keypoints=true
```

* **Type:** `boolean`
* **Default:** `false`
* <mark style="color:$success;">**Plan: Only for Developer/Custom/Company only**</mark>

When enabled, PoseTracker emits `type: "keypoints"` messages.

***

### Payload shape (example)

```json
{
  "type": "keypoints",
  "timestampMs": 1730000000000,
  "frameId": 421,
  "keypoints": [
    { "name": "nose", "x": 0.51, "y": 0.12, "z": -0.02, "score": 0.99 },
    { "name": "left_shoulder", "x": 0.42, "y": 0.31, "z": -0.01, "score": 0.97 }
  ]
}
```

Coordinates are normalized (0..1) relative to the input frame unless otherwise specified by the endpoint implementation.

***

### Error behavior (Free plan)

```json
{
  "type": "error",
  "code": "developer_feature_not_allowed",
  "message": "You cannot use developer features on your current plan.",
  "details": { "blocked": ["keypoints"] }
}
```