# Astral

## Docs

- [Create and manage API keys for your organization](https://docs.nexrex.ai/account/api-keys.md): Generate API keys to integrate the Astral API into your own tools and workflows. Only head coaches can create and revoke keys for their organization.
- [Control who can see your profile and activity data](https://docs.nexrex.ai/account/privacy-settings.md): Manage your Astral privacy settings to choose what training data, race history, and profile details are visible to your coach, group, and the public.
- [Subscription plans and billing for Astral athletes](https://docs.nexrex.ai/account/subscription-plans.md): Understand the free and Pro plans available in Astral, what each includes, how to upgrade, and how to manage or cancel your subscription.
- [Chat with Rex, your Astral AI running coach](https://docs.nexrex.ai/ai/ai-coach-chat.md): Rex, your Astral AI running coach, answers training questions in real time with context from your activity history and training plan.
- [Food scan: AI nutrition analysis from photos](https://docs.nexrex.ai/ai/food-scan.md): Photograph a meal and get an instant nutrition breakdown — calories, protein, carbs, fat, and fiber — estimated by AI from the image.
- [Generate multi-week training plans with Astral AI](https://docs.nexrex.ai/ai/training-plan-generation.md): Generate complete multi-week running training plans with AI. Review and edit a text draft before the AI builds out every structured workout.
- [Activities API — Log and Manage Workouts](https://docs.nexrex.ai/api-reference/activities.md): Create, retrieve, update, and delete activity records for your athletes. Supports run, bike, swim, walk, hike, and workout activity types.
- [AI Coach API — Generate Training Plans with AI](https://docs.nexrex.ai/api-reference/ai-coach.md): Generate multi-week training plans with Astral's AI. Synchronous and SSE streaming endpoints available. Requires coach role and coach_agent feature.
- [Analytics API — Athlete and Training Metrics](https://docs.nexrex.ai/api-reference/analytics.md): Query athlete profiles, running stats, fitness trends, and coach-facing batch metrics. All analytics endpoints require a valid bearer token.
- [Authentication endpoints: signup, login, token refresh](https://docs.nexrex.ai/api-reference/auth.md): Complete reference for email signup, Firebase login, token refresh, logout, and password reset — all endpoints under /api/v1/auth.
- [Authenticate requests to the Astral REST API](https://docs.nexrex.ai/api-reference/authentication.md): Obtain a Bearer token via email signup or Firebase, then include it in the Authorization header. Organization integrations use API keys.
- [Groups API — Organize Athletes into Teams](https://docs.nexrex.ai/api-reference/groups.md): Create and manage training groups within an organization. Groups let coaches assign workouts and track stats for subsets of their athlete roster.
- [Integrations API — Strava, Garmin, and Apple Health](https://docs.nexrex.ai/api-reference/integrations.md): Connect Strava, Garmin Connect, and Apple Health to Astral so activities sync automatically. Covers OAuth flows and disconnect endpoints.
- [Organizations API — Manage Teams and Coaches](https://docs.nexrex.ai/api-reference/organizations.md): Create and manage organizations, coaches, and athlete members. Organizations are the top-level container for all coaches and athletes in Astral.
- [Astral REST API: base URL, auth, and error format](https://docs.nexrex.ai/api-reference/overview.md): All Astral API endpoints, base URL, authentication methods, HTTP status codes, error response format, and available resource types.
- [Races API — Create and Manage Race Events](https://docs.nexrex.ai/api-reference/races.md): Create, retrieve, update, and delete race events. Supports run, bike, swim, triathlon, walk, and hike race types with filtering and search.
- [Training Plans API — Build and Assign Structured Plans](https://docs.nexrex.ai/api-reference/training-plans.md): Create training plan templates, manage a reusable workout library, and assign plans to athletes. Supports multi-week structured programs across all sport types.
- [User profile endpoints: read, update, and preferences](https://docs.nexrex.ai/api-reference/users.md): Read and update Astral user profiles, preferences, usernames, and public profile data. Endpoints are under /api/v1/users. Requires auth.
- [Stripe Webhooks — Subscription Event Reference](https://docs.nexrex.ai/api-reference/webhooks.md): Configure Stripe webhooks to receive subscription lifecycle events from Astral. Covers event types, payload shapes, and signature verification.
- [Analyze athlete performance and training load in Astral](https://docs.nexrex.ai/coaches/analytics.md): Track athlete fitness, running trends, and training load — from individual athlete profiles to group-level performance dashboards.
- [Create and manage training groups for your athletes](https://docs.nexrex.ai/coaches/groups.md): Organize athletes into groups, assign training plans to everyone at once, and track activity and performance across group members.
- [Add, manage, and organize athletes in Astral](https://docs.nexrex.ai/coaches/managing-athletes.md): Invite new athletes and add existing Astral users to your organization, update member profiles, and assign training plans to your roster.
- [Notifications and Broadcasts for Coaches](https://docs.nexrex.ai/coaches/notifications.md): Send push notifications and broadcast messages to athletes, review weekly AI summaries, and manage your notification center as an Astral coach.
- [Activities: Logging and tracking your runs](https://docs.nexrex.ai/concepts/activities.md): Activities are your completed and scheduled workouts in Astral. Learn how to log runs, what data is captured, and how AI summaries are generated.
- [Astral organizations: how coaching clubs work](https://docs.nexrex.ai/concepts/organizations.md): Learn what an Astral organization is, how athletes join, how coaches manage members, and how head coach and assistant roles interact.
- [Astral roles: Athlete, Coach, and Head Coach explained](https://docs.nexrex.ai/concepts/roles.md): Understand Astral's Athlete and Coach roles, what each can do, and how the Head Coach and Assistant Coach sub-roles affect feature access.
- [Training plans: Structure, levels, and AI generation](https://docs.nexrex.ai/concepts/training-plans.md): Astral training plans are multi-week workout schedules assigned to athletes. Learn plan structure, difficulty levels, and AI versus manual creation.
- [Connect Apple Health to Astral on iPhone and Apple Watch](https://docs.nexrex.ai/integrations/apple-health.md): Sync your Apple Watch workouts and iPhone health metrics to Astral so your AI coach has a complete picture of your training and recovery.
- [Connect Garmin Connect to Astral for automatic syncing](https://docs.nexrex.ai/integrations/garmin.md): Link your Garmin account so activities from your Garmin device sync automatically to Astral, giving your AI coach up-to-date training data.
- [Connect Strava to Astral for automatic run syncing](https://docs.nexrex.ai/integrations/strava.md): Link your Strava account to Astral so every run you record on Strava appears automatically in your training history, ready for AI coaching.
- [NexRex: AI-powered coaching platform](https://docs.nexrex.ai/introduction.md): Astral connects athletes and coaches through AI training plans, activity tracking, and real-time coaching chat. Get started in minutes.
- [Get started with Astral as an athlete in 5 steps](https://docs.nexrex.ai/quickstart-athlete.md): Create your Astral account, set up your athlete profile, connect Strava or Garmin, and start your first training plan in under 10 minutes.
- [Set up your Astral coaching organization in 5 steps](https://docs.nexrex.ai/quickstart-coach.md): Sign up as a coach, create your organization, add athletes, and generate your first AI training plan from the Astral coach console.

## OpenAPI Specs

- [openapi](https://docs.nexrex.ai/api-reference/openapi.json)