> ## 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. # Back Office: link an athlete directly to an agent > Server to server only, called by Back Office Link Athlete (ENG-1568). Creates the representation without any invitation, token or athlete action, so a missing, valid or expired invitation never matters. Same rules as invitation acceptance: the agent must be approved, the athlete approved or pending, and the athlete not represented by another agent. On success every outstanding invitation for the athlete is deleted, and once the link is committed the agent gets notification 51, the athlete the `Athlete now represented by Agent` confirmation, and university admins the existing connection email. A repeat for the same pair returns `already_linked` with the existing row and sends nothing, so the call is safe to retry. ## OpenAPI ````yaml /storage/api-docs/api-docs.json post /internal/agent-representations/link 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: /internal/agent-representations/link: post: tags: - Internal summary: 'Back Office: link an athlete directly to an agent' description: >- Server to server only, called by Back Office Link Athlete (ENG-1568). Creates the representation without any invitation, token or athlete action, so a missing, valid or expired invitation never matters. Same rules as invitation acceptance: the agent must be approved, the athlete approved or pending, and the athlete not represented by another agent. On success every outstanding invitation for the athlete is deleted, and once the link is committed the agent gets notification 51, the athlete the `Athlete now represented by Agent` confirmation, and university admins the existing connection email. A repeat for the same pair returns `already_linked` with the existing row and sends nothing, so the call is safe to retry. operationId: internalLinkAgentRepresentation requestBody: required: true content: application/json: schema: required: - agent_id - athlete_id - source - admin_id properties: agent_id: type: integer example: 35112 athlete_id: type: integer example: 36550 source: type: string enum: - back_office example: back_office admin_id: description: >- Back Office admin taken from the session, for the audit trail. Not an authorization. type: integer example: 1 type: object responses: '200': description: Linked, or already linked to this agent content: application/json: schema: properties: status: type: string example: success data: properties: outcome: type: string enum: - created - already_linked example: created agent_athlete_id: type: integer example: 9012 type: object type: object '400': description: The agent or athlete is not eligible. content: application/json: schema: properties: message: type: string example: This agent is not able to accept athletes right now. error_code: type: string enum: - AGENT_NOT_APPROVED - ATHLETE_NOT_APPROVED example: AGENT_NOT_APPROVED type: object '401': description: Missing or wrong X-API-KEY. '409': description: Another agent already represents the athlete. content: application/json: schema: properties: message: type: string example: This athlete is already represented by another agent. error_code: type: string enum: - ATHLETE_REPRESENTED_BY_OTHER_AGENT example: ATHLETE_REPRESENTED_BY_OTHER_AGENT type: object '422': description: >- Invalid input, or an id that is not an existing non-deleted agent/athlete (error_code LINK_ACCOUNT_INVALID). security: - serverToServerApiKey: [] components: securitySchemes: bearerAuth: type: http description: >- JWT Bearer token authentication. Use the /api/login endpoint to obtain a token. scheme: bearer bearerFormat: JWT serverToServerApiKey: type: apiKey description: Server-to-Server API Key for internal/lambda/cron calls name: X-API-KEY in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.