# TOKEN (required)

Real-time endpoint:

```
https://app.posetracker.com/pose_tracker/tracking?token=YOUR_API_KEY&exercise=squat
```

Upload endpoint:

```
https://app.posetracker.com/pose_tracker/upload_tracking?token=YOUR_API_KEY&source=video&exercise=squat
```

***

### Definition

* **Type:** `string`
* **Required:** yes
* **Description:** Your PoseTracker API key.

PoseTracker uses the token to:

* authenticate requests
* determine plan restrictions (Free vs Developer vs Custom/Company)
* enable/disable developer outputs like keypoints, angles, BlazePose, export, etc.

***

### Error behavior

If the token is missing or invalid, PoseTracker emits:

```json
{
  "type": "error",
  "code": "invalid_token",
  "message": "Invalid or missing token."
}
```

If the token is valid but does not allow a requested feature (example: `angles=true` on Free plan), PoseTracker emits:

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