> ## Documentation Index > Fetch the complete documentation index at: https://developer.mogl.online/llms.txt > Use this file to discover all available pages before exploring further. # Fill in profile details for a represented athlete > Lets an agent complete an athlete's profile without the athlete being involved (ENG-1474). Authorization runs through the active agent_athletes relationship, so an agent can never edit someone else's athlete. * * The Edit modal is the athlete's own edit experience rendered as a modal, so the field set mirrors the athlete's `POST /editAthleteWebsite` and the same follow-ups run: graduation year re-decides whether they still count as a current athlete, bio and skills close the matching onboarding to-do, and profile completeness is recalculated so the roster percentage stays honest. * * Every field is optional and only the fields actually sent are written, so the modal can save partial progress; a field that is present must still be valid. Sending either name part rewrites the athlete's display `name` from both. * * Not accepted here on purpose: the profile photo, which keeps its own endpoint at POST /agent/athletes/{athleteId}/photo; social accounts, which go through the Link Social Media flow; and email and password, which would let an agent take over the athlete's login. ## OpenAPI ````yaml /storage/api-docs/api-docs.json put /agent/athletes/{athleteId}/profile openapi: 3.0.0 info: title: MOGL Core API description: >- MOGL Platform Core API — powering athlete NIL deals, brand partnerships, agent management, payments, messaging, and more. * * ## Authentication * - **JWT Bearer Token**: Most endpoints require a Bearer token obtained via `/api/login`. * - **Server-to-Server API Key**: Internal/lambda/cron endpoints use an `X-API-KEY` header. * * ## Rate Limiting * - Registration & login endpoints: 4–15 requests per minute * - Public/influencer endpoints: 200 requests per minute * - Authenticated endpoints: standard Laravel throttle version: 1.0.0 servers: - url: http://localhost/mogl/mogl-backend/api description: Local - url: https://dev-api.mogl.online/api description: Dev - url: https://staging-api.mogl.online/api description: Staging - url: https://api.mogl.online/api description: Production security: - bearerAuth: [] tags: - name: Authentication description: Login, registration, password reset - name: User Registration - Common description: Common user registration & email check - name: User Registration - Athlete description: Athlete registration & onboarding steps - name: User Registration - Partner description: Partner/Brand registration & onboarding steps - name: User Registration - Agent description: Agent registration & onboarding steps - name: User Registration - Fan description: Fan registration & onboarding steps - name: User Profile description: User profile management, settings, social media - name: Athlete description: 'Athlete-specific endpoints: search, details, availability' - name: Athlete - Availability Confirmation description: Post-hiring availability confirmation workflow - name: Athlete - NIL Feed description: Athlete NIL feed and partner search - name: Athlete - AI Assistant description: >- AI-powered job assistant for athletes — chat, conversation history, read state, and clarification drafts - name: Athlete - AI Waitlist description: AI Athlete Assistant waitlist status, social proof, and joining - name: Partner description: Partner/Brand-specific endpoints - name: Partner - External Job description: External job link & applicant management - name: Partner - Deliverable Report description: Deliverable detail reports for brands - name: Partner - Screening Questions description: Screening question reports - name: Partner - Contract Management description: Brand contract management with athletes - name: Partner - Content Library description: Brand content library for deliverable assets - name: Agent description: Agent profile, athlete management, contracts - name: Agent - Athletes description: Agent-athlete relationship management - name: Agent - Stripe description: Agent payment methods & billing via Stripe - name: Agent - Pay description: 'Agent-wide payout feed: money MOGL sends the agent through Stripe Express' - name: Agent - Contracts description: Agent athlete contract management - name: Agent - Availability Confirmation description: Agent managing athlete job availability - name: Agent - Roster Import description: >- CSV client list import through CSVBox (ENG-1619 / ENG-1702): session, CSVBox webhook, progress, row results, retry - name: Agent - Roster Pages description: >- ENG-1685: My Roster Link, public roster directory, public roster page, and roster SEO URL resolution. A roster is the agent's current linked athletes; nothing is stored separately. - name: Jobs description: Job/deal CRUD, search, invitations, hiring, deliverables - name: Deals description: Deal listing, my deals, bulk operations - name: Deal Folder description: >- Deal folder file workflow — uploads, replacements, approvals, revisions, comments. Accessible by athlete, partner/brand, agent, and iOS clients (per-action authorisation enforced server-side). - name: Deal Folder iOS API description: >- iOS-only direct-to-S3 multipart upload endpoints for deal folder files (initiate/complete for new uploads and replacements). Web clients should use the standard `Deal Folder` upload/replace endpoints instead. - name: Chat description: Messaging, chat contacts, notifications - name: Notifications description: Notification preferences, in-app notifications - name: Payments description: Stripe payments, payment history, cards, bulk pay - name: Subscription description: Brand subscription plans & management - name: Public Pages description: Public content endpoints (no auth required) - name: Public - Influencer/SEO description: Public influencer discovery, sitemaps, directories - name: Services description: Athlete service marketplace - name: iOS Device description: iOS device tokens, live activities - name: Onboarding Tutorial description: Onboarding tutorial progress - name: MOGL Rosters description: Roster management & display - name: Internal / Cron description: Server-to-server and cron job endpoints - name: Internal / AI Assistant Tools description: >- Server-to-server Athlete Assistant tool gateway used by mogl-ai-service. Eight Laravel tools share POST /internal/ai-assistant/tools/{tool}. search_kb is Python-local and is not in this path enum. - name: Internal / QA Scenario Lab description: >- Feature-flagged DEV/STAGING-only endpoints called by the authorized Back Office QA Scenario Lab. - name: Affiliate description: Athlete affiliate links & tracking - name: Internal description: Internal - name: Public - Social Linking description: Public - Social Linking paths: /agent/athletes/{athleteId}/profile: put: tags: - Agent - Athletes summary: Fill in profile details for a represented athlete description: >- Lets an agent complete an athlete's profile without the athlete being involved (ENG-1474). Authorization runs through the active agent_athletes relationship, so an agent can never edit someone else's athlete. * * The Edit modal is the athlete's own edit experience rendered as a modal, so the field set mirrors the athlete's `POST /editAthleteWebsite` and the same follow-ups run: graduation year re-decides whether they still count as a current athlete, bio and skills close the matching onboarding to-do, and profile completeness is recalculated so the roster percentage stays honest. * * Every field is optional and only the fields actually sent are written, so the modal can save partial progress; a field that is present must still be valid. Sending either name part rewrites the athlete's display `name` from both. * * Not accepted here on purpose: the profile photo, which keeps its own endpoint at POST /agent/athletes/{athleteId}/photo; social accounts, which go through the Link Social Media flow; and email and password, which would let an agent take over the athlete's login. operationId: agentUpdateAthleteProfile parameters: - name: athleteId in: path description: Athlete user id. Must be on the authenticated agent's roster. required: true schema: type: integer example: 28550 requestBody: required: false content: application/json: schema: properties: first_name: type: string maxLength: 100 example: Ayden last_name: type: string maxLength: 100 example: Syal contact_number: description: Rejected when another live user already has it. type: string maxLength: 20 example: '4155551809' nullable: true jersey_no: type: string maxLength: 10 example: '15' nullable: true dob: type: string format: date example: '1998-04-29' nullable: true location: description: The Hometown field. type: string maxLength: 255 example: Berkeley, CA, USA nullable: true is_private: type: string enum: - 'Y' - 'N' example: 'N' nullable: true sport_category_id: description: Must exist in sports_categories. type: integer example: 12 nullable: true bio: type: string maxLength: 5000 example: Junior wide receiver. nullable: true highlights: description: The Career Highlights field. type: string maxLength: 5000 example: All-American NCAA D1AA 2023 nullable: true university_id: description: Must exist in colleges. type: integer example: 340 nullable: true height: description: Total inches. type: number example: 70 nullable: true weight: description: Pounds. type: number example: 200 nullable: true skills: type: string maxLength: 1000 example: Cooking, Acting, Public Speaking nullable: true hat_size: type: string maxLength: 50 example: 7 1/2 nullable: true shirt_size: type: string maxLength: 50 example: XL nullable: true pants_size: type: string maxLength: 50 example: '34' nullable: true shoes_size: type: string maxLength: 50 example: '11.5' nullable: true expected_graduation_date: type: string maxLength: 50 example: '2027' nullable: true gender: type: string maxLength: 50 example: Male nullable: true us_citizen: type: string enum: - 'Y' - 'N' example: 'Y' nullable: true type: object responses: '200': description: Profile updated content: application/json: schema: properties: message: type: string example: Athlete profile updated. data: properties: athlete_id: type: integer example: 28550 profile_complete: description: >- Recalculated completeness after the save, so the modal can show the new percentage without re-fetching the roster. type: number format: float example: 87.5 type: object type: object '400': description: The agent is not approved, or does not represent this athlete. content: application/json: schema: properties: message: type: string example: You can only manage athletes you represent. error_code: type: string enum: - AGENT_NOT_APPROVED - ATHLETE_NOT_LINKED example: ATHLETE_NOT_LINKED type: object '422': description: A supplied field failed validation. security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http description: >- JWT Bearer token authentication. Use the /api/login endpoint to obtain a token. scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.