POST /api/v1/tracker/shares

Create a new shared tracker configuration to share tracker data with another user.

Permissions

Request Body Parameters

Response

201 Created

<shared tracker resource>

• See Shared Tracker Resource

Error Responses

Example Request

curl -X POST "https://api.example.com/api/v1/tracker/shares" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "viewer_user_id": 456,
    "start_date": "2024-01-01",
    "end_date": "2024-01-31",
    "description": "January fitness tracking data",
    "include_wakeup": true,
    "include_weight": false,
    "include_water": true,
    "include_sleep": true,
    "include_supplement": false,
    "include_meal": true,
    "include_workout": true
  }'

Example Response

{
  "data": <shared tracker resource>
}

See Shared Tracker Resource for the complete response structure.

Notes

• The user_id is automatically set to the authenticated user's ID
• All include_* flags default to true if not specified
• All notify_* flags default to false if not specified
• If both start_date and end_date are provided, end_date must be after start_date
• The viewer_user_id must reference an existing user
• When start_date and end_date are null, all tracker data is shared without date restrictions