> ## 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.

# Content Tab — paginated job list with deal-folder rollups

> Returns the partner Content Tab job list — one row per job, with rolled-up deal-folder stats: active athlete count, deliverable count, state and file counts, athletes preview, approved summary, and rolled-up status.

The filter body uses the same contract as the existing content-library list endpoint. Only active folders are returned. Sorted newest-first by job posted date.



## OpenAPI

````yaml /storage/api-docs/api-docs.json post /partner/content/deal-folders
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 - Contracts
    description: Agent athlete contract management
  - name: Agent - Availability Confirmation
    description: Agent managing athlete job availability
  - 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 Athlete Assistant Tools
    description: >-
      Dual-authenticated, athlete-scoped tool gateway used only by the AI
      service
  - name: Affiliate
    description: Athlete affiliate links & tracking
paths:
  /partner/content/deal-folders:
    post:
      tags:
        - Partner - Content Library
      summary: Content Tab — paginated job list with deal-folder rollups
      description: >-
        Returns the partner Content Tab job list — one row per job, with
        rolled-up deal-folder stats: active athlete count, deliverable count,
        state and file counts, athletes preview, approved summary, and rolled-up
        status.


        The filter body uses the same contract as the existing content-library
        list endpoint. Only active folders are returned. Sorted newest-first by
        job posted date.
      operationId: contentDealFoldersIndex
      parameters:
        - name: page
          in: query
          description: Page number (1-indexed).
          required: false
          schema:
            type: integer
            example: 1
        - name: limit
          in: query
          description: Items per page (default 20).
          required: false
          schema:
            type: integer
            example: 20
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                date_filter_range:
                  description: >-
                    One of: `All`, `last_30_days`, `last_week`, `this_week`, or
                    a custom range `MM/DD/YYYY-MM/DD/YYYY`.
                  type: string
                  example: All
                is_all_selected:
                  description: >-
                    When `true`, all jobs are selected (use `excluded_job_id` to
                    subtract). When `false`, only the IDs in `job_id` are
                    included.
                  type: boolean
                  example: true
                job_id:
                  description: >-
                    Specific job IDs to include (used when `is_all_selected =
                    false`).
                  type: array
                  items:
                    type: integer
                  example:
                    - 2768
                    - 2731
                excluded_job_id:
                  description: Job IDs to exclude (used when `is_all_selected = true`).
                  type: array
                  items:
                    type: integer
                  example:
                    - 123
              type: object
      responses:
        '200':
          description: Paginated job list with deal-folder rollups
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  message:
                    type: string
                    example: Content Deal Folders
                  data:
                    type: array
                    items:
                      properties:
                        job_id:
                          type: integer
                          example: 2768
                        job_name:
                          type: string
                          example: Summer Campaign
                        job_posted_at:
                          type: string
                          format: date-time
                          example: '2026-05-30T12:00:00Z'
                        active_athlete_count:
                          type: integer
                          example: 2
                        deliverable_count:
                          type: integer
                          example: 3
                        deal_folder_status:
                          description: Rolled-up label across the job's deliverables.
                          type: string
                          example: Needs Approval
                        state_counts:
                          description: >-
                            Deliverable-level counts (`awaiting_upload`,
                            `needs_approval`, `revision_requested`,
                            `file_approved`).
                          properties:
                            awaiting_upload:
                              type: integer
                              example: 1
                            needs_approval:
                              type: integer
                              example: 1
                            revision_requested:
                              type: integer
                              example: 0
                            file_approved:
                              type: integer
                              example: 1
                          type: object
                        file_counts:
                          description: >-
                            File-level counts (`total`, `uploaded`, `approved`,
                            `needs_revision`).
                          properties:
                            total:
                              type: integer
                              example: 4
                            uploaded:
                              type: integer
                              example: 3
                            approved:
                              type: integer
                              example: 1
                            needs_revision:
                              type: integer
                              example: 0
                          type: object
                        athletes_preview:
                          description: >-
                            Up to 4 athlete previews for the job-card avatar
                            stack.
                          type: array
                          items:
                            properties:
                              athlete_id:
                                type: integer
                                example: 16070
                              athlete_name:
                                type: string
                                example: Jane Doe
                              profile_image:
                                type: string
                                nullable: true
                            type: object
                        latest_activity_at:
                          type: string
                          format: date-time
                          example: '2026-06-10T09:30:00Z'
                          nullable: true
                        approved_summary:
                          description: Display string e.g. `0/3 approved`.
                          type: string
                          example: 0/3 approved
                          nullable: true
                      type: object
                  total_count:
                    type: integer
                    example: 5
                  current_page:
                    type: integer
                    example: 1
                  per_page:
                    type: integer
                    example: 20
                  last_page:
                    type: integer
                    example: 1
                type: object
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
        '500':
          description: Internal error fetching content deal folders
      security:
        - bearerAuth: []
components:
  schemas:
    UnauthorizedResponse:
      properties:
        message:
          type: string
          example: Unauthenticated.
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      description: >-
        JWT Bearer token authentication. Use the /api/login endpoint to obtain a
        token.
      scheme: bearer
      bearerFormat: JWT

````