# Generated reference for the Airaa public API.
# Source of truth for every page under /docs/api. See lib/openapi.ts.
openapi: 3.1.0
info:
  title: Airaa API
  version: '2026-08-28'
  summary: Read your communities, campaigns, submissions, members and chats over HTTP.
  description: |-
    Thirteen read-only tools over one POST shape. These are the same tools an AI assistant sees when you connect Airaa over MCP, available as plain HTTP.

    Every call is `POST /api/ai/mcp/tools/{tool}/execute` with arguments wrapped in an `args` object, and every success returns a single `result` key.

    Your key acts as you. It reaches only communities where you are already an admin or a moderator, so it can never see another brand's data.

    Vocabulary. A **community** is what `projectId` identifies: the product says community, the wire format still says project. A **bounty campaign** (`campaignType: "social"`) is what the product has also called a social campaign or instant tasks. A **video campaign** covers both `clipping` and `ugc`. Submissions are split along that line, one endpoint each.

    Response envelopes differ per tool: `metadata` on the submissions and leaderboard endpoints, `counts` on `get_project_campaigns`, `{page, limit, hasMore}` on `get_chat_threads`, and a bare array on `get_project_members_detailed` and `get_chat_messages`. Some failures return HTTP 200 with the error nested at `result.error`, so check for both.
  contact:
    name: Airaa
    url: https://airaa.xyz
servers:
- url: https://app.airaa.xyz
security:
- bearerAuth: []
tags:
- name: Communities
  description: 'Every other tool needs a `projectId`. These two are where you get one, and where you read what a community is: its profile, its team, and the totals it has paid out.'
- name: Campaigns
  description: List one community's campaigns, then read any one of them in full. `get_campaign_details` covers both bounty and video campaigns. Its `detailVariant` field tells you which shape came back.
- name: Submissions
  description: |-
    Bounty campaigns use one endpoint, video campaigns use the other, and the campaign's `campaignType` tells you which: `social` is a bounty campaign, `clipping` and `ugc` are video campaigns. Call the wrong one and you get an error naming the right one.

    Read [Reading the numbers](/docs/api/reading-the-numbers) before reading a row. `tokenReward` is not what was paid, and `username` is not the Airaa username.
- name: People
  description: Who is in a community, and who earned the most in it. In both responses `username` is the Airaa username, not a handle on X, TikTok or Instagram. Platform handles live in `platforms[].handle` on a member and `socialConnections[].externalUsername` on a leaderboard row.
- name: Account
  description: Which account the key acts as, the tokens campaigns can pay out in, and the server clock.
- name: Chat
  description: |-
    These are real direct messages between a brand and its creators. A creator wrote them expecting a conversation with the brand, not an API feed.

    The `media` attachments and `videoUrl` archives are creator-uploaded files served from the Airaa CDN. Those links are private to the brand and should not be shared or republished.

    Both tools are read-only. The API cannot send a message, mark a thread read, or delete anything; those stay in the dashboard.
paths:
  /api/ai/mcp/tools/list_manageable_projects/execute:
    post:
      operationId: list_manageable_projects
      summary: List communities you can manage
      tags:
      - Communities
      description: |-
        Which communities can this key reach?

        Every other tool needs a `projectId`, and this is where you get one. Returns the communities where you are an admin or a moderator. An empty list means the key cannot reach any community data. Passing a `projectId` you do not administer returns `403` everywhere else.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties: {}
                  additionalProperties: false
              required:
              - args
            example:
              args: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      projects:
                        type: array
                        items:
                          $ref: '#/components/schemas/ManageableProject'
                    required:
                    - projects
                required:
                - result
              examples:
                '200':
                  value:
                    result:
                      projects:
                      - projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        slug: lumenlabs
                        name: Lumen Labs
                        role: ADMIN
                        logo: https://cdn.airaa.xyz/projects/lumenlabs/logo.png
                        pointsToken:
                          id: b6c0e83f-4a71-4d92-8e15-3c7f9021ba64
                          name: Lumen Points
                          symbol: LUMEN
                          logo: https://cdn.airaa.xyz/tokens/lumen.png
                        campaignCommission: 10
                      - projectId: 8b41d0c5-72e6-4a19-8f3b-2d95e4a17c68
                        slug: northwind
                        name: Northwind Audio
                        role: MODERATOR
                        logo: null
                        pointsToken: null
                        campaignCommission: 10
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_project_info/execute:
    post:
      operationId: get_project_info
      summary: Get a community profile
      tags:
      - Communities
      description: |-
        What is this community, and how big is it?

        The community's profile (name, slug, category, logo, banner, description and connected socials) alongside the totals the dashboard header shows: member counts, active and total campaigns, rewards and points distributed, the team roster, and X follower counts.

        `projectId` is required. Omitting it returns `400`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectId:
                      type:
                      - string
                      - 'null'
                      description: The community id, from `list_manageable_projects`.
                  additionalProperties: false
                  required:
                  - projectId
              required:
              - args
            example:
              args:
                projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/ProjectInfo'
                required:
                - result
              examples:
                '200':
                  value:
                    result:
                      id: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                      slug: lumenlabs
                      name: Lumen Labs
                      isWhitelabelEnabled: false
                      category: Tech
                      logo: https://cdn.airaa.xyz/projects/lumenlabs/logo.png
                      banner: https://cdn.airaa.xyz/projects/lumenlabs/banner.png
                      description: Focus tooling for people who build things.
                      twitterProfileUrl: https://x.com/lumenlabs
                      totalMemberCount: 1284
                      activeMembersCount: 417
                      isUserMember: true
                      userMembershipStatus: ACTIVE
                      userRole: ADMIN
                      activeCampaignsCount: 2
                      totalCampaignsCount: 11
                      rewardsDistributed: '48210.50'
                      totalPointsDistributed: '1920000'
                      erc20Totals:
                      - totalAmount: '48210.50'
                        symbol: USDC
                        decimals: 6
                      pointsTotals:
                      - totalAmount: '1920000'
                        symbol: LUMEN
                        decimals: 0
                      teamMembers:
                      - userId: d3b71f68-92a4-4c05-8e37-6b1902ac4f5d
                        role: ADMIN
                        photoUrl: https://cdn.airaa.xyz/users/priya.jpg
                        username: priyanotes
                        name: Priya R.
                      twitterFollowersCount: 84500
                      pointsToken:
                        symbol: LUMEN
                        logo: https://cdn.airaa.xyz/tokens/lumen.png
                      socials:
                        web: https://lumenlabs.com/
                        twitter: https://x.com/lumenlabs
                        telegram: null
                        discord: https://discord.gg/lumenlabs
                        youtube: null
                        instagram: https://instagram.com/lumenlabs
                        tiktok: null
                      pendingActions:
                        gigApplications:
                          count: 18
                          preview:
                          - userId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                            username: marasolace
                            photoUrl: https://cdn.airaa.xyz/users/mara.jpg
                        joinRequests:
                          count: 4
                          preview:
                          - userId: 2c8f45d1-6e93-40a7-b25c-1d3e9f7a6b08
                            username: devonbuilds
                            photoUrl: https://cdn.airaa.xyz/users/devon.jpg
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_project_campaigns/execute:
    post:
      operationId: get_project_campaigns
      summary: List campaigns in a community
      tags:
      - Campaigns
      description: |-
        What campaigns are running in this community?

        One community's campaigns, filterable by status and by type. `projectId` is required: this lists a single community's campaigns, not every campaign your key can reach. Campaigns hidden in the dashboard are excluded.

        This endpoint paginates with a `counts` object (live, draft and ended totals plus total spent) rather than the `metadata` envelope the other paginated tools return.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    statusBy:
                      anyOf:
                      - type: string
                        enum:
                        - LIVE
                        - ENDED
                        - DRAFT
                        - PAYMENT_PENDING
                      - type: 'null'
                      description: Narrow to one campaign status.
                    campaignType:
                      anyOf:
                      - type: string
                        enum:
                        - all
                        - instant_tasks
                        - clipping
                        - UGC
                      - type: 'null'
                      description: Narrow to one campaign family. `instant_tasks` is the bounty campaigns; `clipping` and `UGC` are the two video campaign types.
                    projectId:
                      type: string
                      description: The community id, from `list_manageable_projects`. Lists this community only.
                    page:
                      type: integer
                      minimum: 1
                      default: 1
                      description: Page number, 1-indexed
                    limit:
                      type: integer
                      minimum: 1
                      maximum: 100
                      default: 10
                      description: Items per page, max 100
                  required:
                  - projectId
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                statusBy: LIVE
                limit: 10
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      campaigns:
                        type: array
                        items:
                          $ref: '#/components/schemas/CampaignListItem'
                      counts:
                        $ref: '#/components/schemas/CampaignCounts'
                      projects:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            name:
                              type: string
                            logo:
                              type:
                              - string
                              - 'null'
                            role:
                              type: string
                              enum:
                              - MEMBER
                              - MODERATOR
                              - ADMIN
                    required:
                    - campaigns
                required:
                - result
              examples:
                '200':
                  summary: Note the counts object where other endpoints return metadata.
                  value:
                    result:
                      campaigns:
                      - id: a7d2f61c-08b5-4e3a-9c14-5f8b73d20e69
                        title: Launch week clips
                        status: LIVE
                        campaignType: clipping
                        taskTypes:
                        - CLIP_X
                        - CLIP_TIKTOK
                        totalPool: '12000.00'
                        remainingPool: '7420.15'
                        usedBudget: '4579.85'
                        platform:
                        - id: f0a4c927-51d8-4b63-9a72-e8d1c3406b5f
                          name: TikTok
                          enabled: true
                        - id: 9d6b23e1-7c40-4f85-b91a-04e7f2d85c63
                          name: Instagram
                          enabled: true
                        payoutType: FCFS
                        tokenType: ERC20
                        tokenSymbol: USDC
                        completedUsersCount: 38
                        incompletedUsersCount: 6
                        hasCounterOffer: false
                        approvedClipsCount: 112
                        impressions: 4820000
                        pendingReviewsCount: 9
                        project:
                          id: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                          name: Lumen Labs
                          logo: https://cdn.airaa.xyz/projects/lumenlabs/logo.png
                        createdAt: '2026-08-04T09:12:44.000Z'
                      - id: c14e7b90-5a23-4f81-b6d7-90e3ac215f42
                        title: Quote the launch thread
                        status: LIVE
                        campaignType: social
                        taskTypes:
                        - QUOTE
                        - REPLY
                        totalPool: '2500.00'
                        remainingPool: '1180.00'
                        usedBudget: '1320.00'
                        platform:
                        - id: 6e2c81b4-3f97-40da-85c1-b70d924ef3a8
                          name: Twitter/X
                          enabled: true
                        payoutType: OFFERS
                        tokenType: ERC20
                        tokenSymbol: USDC
                        completedUsersCount: 44
                        incompletedUsersCount: 12
                        hasCounterOffer: true
                        approvedClipsCount: 0
                        impressions: 612400
                        pendingReviewsCount: 3
                        project:
                          id: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                          name: Lumen Labs
                          logo: https://cdn.airaa.xyz/projects/lumenlabs/logo.png
                        createdAt: '2026-07-21T15:02:10.000Z'
                      counts:
                        live: 2
                        draft: 1
                        ended: 8
                        spent: 5899.85
                      projects:
                      - id: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        name: Lumen Labs
                        logo: https://cdn.airaa.xyz/projects/lumenlabs/logo.png
                        role: ADMIN
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_campaign_details/execute:
    post:
      operationId: get_campaign_details
      summary: Get campaign details
      tags:
      - Campaigns
      description: |-
        What are this campaign's settings, budget and results?

        Read `detailVariant` first. The same call returns two different bodies: `clipping_owner` for a video campaign that has left draft, and `social_owner` for a bounty campaign and for any campaign still in `DRAFT`.

        Both variants carry `campaign`, `project`, `stats` and `budget`. The `social_owner` variant populates `tasks` and leaves `clippingOwner` null. The `clipping_owner` variant fills `clippingOwner` with the analytics payload: submission counts, reach split into initial and current, per-platform payout rules, and bonus milestones.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectCampaignId:
                      type: string
                      description: The campaign id, from `get_project_campaigns`. Works for a bounty or a video campaign.
                  required:
                  - projectCampaignId
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectCampaignId: a7d2f61c-08b5-4e3a-9c14-5f8b73d20e69
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/CampaignDetail'
                required:
                - result
              examples:
                clipping_owner:
                  summary: A video campaign past draft. clippingOwner is populated, tasks is empty.
                  value:
                    result:
                      campaignType: clipping
                      detailVariant: clipping_owner
                      campaign:
                        id: a7d2f61c-08b5-4e3a-9c14-5f8b73d20e69
                        projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        title: Launch week clips
                        status: LIVE
                        type: clipping
                        imageUrl: https://cdn.airaa.xyz/campaigns/launch-week/cover.png
                        startDate: '2026-08-05T00:00:00.000Z'
                        endDate: '2026-09-05T00:00:00.000Z'
                        createdAt: '2026-08-04T09:12:44.000Z'
                        approvalMode: MANUAL
                        needsDraft: false
                        userEligibilityCriteria:
                          minFollowers: 1000
                      project:
                        id: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        name: Lumen Labs
                        slug: lumenlabs
                        logo: https://cdn.airaa.xyz/projects/lumenlabs/logo.png
                      stats:
                        creators: 44
                        reach: 4820000
                        likes: 291400
                        quotes: 0
                        post: 112
                      budget:
                        totalPool: '12000.00'
                        remainingPool: '7420.15'
                        tokenType: ERC20
                        tokenSymbol: USDC
                        tokenAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                        chainId: '8453'
                        decimals: 6
                      tasks: []
                      clippingOwner:
                        demographicsRequired: true
                        demographicsAudienceRule: 60% US or UK
                        eligibilitySummary:
                          mode: open
                          guild: null
                        overview:
                          creatorsCount: 44
                          totalSubmissionsCount: 137
                          submissionsCount: 128
                          pendingSubmissionsCount: 9
                          approvedSubmissionsCount: 112
                          rejectedSubmissionsCount: 7
                          paidSubmissionsCount: 98
                          reach: 4820000
                          currentReach: 4913200
                          initialReach: 93200
                          likes: 291400
                          comments: 18720
                        budget:
                          label: Campaign budget
                          totalPool: '12000.00'
                          remainingPool: '7420.15'
                          usedBudget: '4579.85'
                          tokenType: ERC20
                          tokenSymbol: USDC
                        tasksTab:
                          requirements:
                            guidelines: Hook in the first two seconds. No captions over the logo.
                            hashtags:
                            - lumenlabs
                            mentions:
                            - '@lumenlabs'
                            urls:
                            - https://lumenlabs.com
                          tasks:
                          - taskId: 7b3e19a2-c845-4d70-9e16-a2f5c80b31d4
                            platformId: f0a4c927-51d8-4b63-9a72-e8d1c3406b5f
                            platformName: TikTok
                            platformSlug: tiktok
                            type: CLIP
                            submissionRequirements:
                              guidelines: Hook in the first two seconds.
                              hashtags:
                                values:
                                - lumenlabs
                                isEnabled: true
                                requireAll: true
                              mentions:
                                values:
                                - '@lumenlabs'
                                isEnabled: true
                                requireAll: false
                              urls:
                                values: []
                                isEnabled: false
                                requireAll: false
                            submissionCounts:
                              total: 82
                              pending: 5
                              approved: 71
                              rejected: 6
                              paid: 63
                              nonRejected: 76
                        settingsTab:
                          userEligibilityCriteria:
                            minFollowers: 1000
                          platformPayouts:
                          - taskId: 7b3e19a2-c845-4d70-9e16-a2f5c80b31d4
                            platformId: f0a4c927-51d8-4b63-9a72-e8d1c3406b5f
                            platformName: TikTok
                            platformSlug: tiktok
                            claimType: FCFS
                            payoutLogic: FORMULA
                            cpm: 1.4
                            fixedPayout: null
                            minViews: 1000
                            maxPayoutPerClip: 250
                            bonusRanges:
                            - views: 100000
                              amount: 50
                            - views: 500000
                              amount: 300
                            tokenType: ERC20
                            tokenSymbol: USDC
                      campaignCommission: 10
                      draftConfig: null
                      eligibilityProject: null
                social_owner:
                  summary: A bounty campaign. tasks is populated, clippingOwner is null.
                  value:
                    result:
                      campaignType: social
                      detailVariant: social_owner
                      campaign:
                        id: c14e7b90-5a23-4f81-b6d7-90e3ac215f42
                        projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        title: Quote the launch thread
                        status: LIVE
                        type: social
                        imageUrl: null
                        startDate: '2026-07-22T00:00:00.000Z'
                        endDate: null
                        createdAt: '2026-07-21T15:02:10.000Z'
                        approvalMode: AI
                        needsDraft: false
                        userEligibilityCriteria:
                          minFollowers: 500
                      project:
                        id: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        name: Lumen Labs
                        slug: lumenlabs
                        logo: https://cdn.airaa.xyz/projects/lumenlabs/logo.png
                      stats:
                        creators: 56
                        reach: 612400
                        likes: 21840
                        quotes: 44
                        post: 44
                      budget:
                        totalPool: '2500.00'
                        remainingPool: '1180.00'
                        tokenType: ERC20
                        tokenSymbol: USDC
                        tokenAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                        chainId: '8453'
                        decimals: 6
                      tasks:
                      - taskId: 48f0d2b7-6a19-4c53-b8e0-71c9a35d6f42
                        type: QUOTE
                        platformName: Twitter/X
                        tokenReward: '20.00'
                        claimedCount: 56
                        approvedCount: 44
                      clippingOwner: null
                      campaignCommission: 10
                      draftConfig: null
                      eligibilityProject: null
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_bounty_campaign_submissions/execute:
    post:
      operationId: get_bounty_campaign_submissions
      summary: List bounty campaign submissions
      tags:
      - Submissions
      description: |-
        Which creators submitted to this bounty campaign, and what are they owed?

        Bounty campaigns only, the type the product has also called social campaigns or instant tasks. One row per creator, with every task they claimed nested underneath, each carrying its own status, URL and engagement counts. On `OFFERS`-claim campaigns, creators who were offered a slot but have not submitted yet are included too.

        `username` here is the creator's handle on the posting platform, not their Airaa username.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectCampaignId:
                      type: string
                      description: 'The campaign id, from `get_project_campaigns`. Must be a bounty campaign (`campaignType: "social"`).'
                    page:
                      type: integer
                      minimum: 1
                      default: 1
                      description: Page number, 1-indexed
                    limit:
                      type: integer
                      minimum: 1
                      maximum: 100
                      default: 10
                      description: Items per page, max 100
                    sortBy:
                      anyOf:
                      - type: string
                        enum:
                        - smart_followers
                        - followers
                        - created_at
                      - type: 'null'
                      description: Order rows by the creator's follower counts, or by when they claimed.
                    sortOrder:
                      anyOf:
                      - type: string
                        enum:
                        - ASC
                        - DESC
                      - type: 'null'
                      description: Sort order
                    statusBy:
                      anyOf:
                      - type: string
                        enum:
                        - PENDING
                        - APPROVED
                        - FAILED
                        - PAID
                        - MILESTONE_BONUS_PAID
                        - DEMOGRAPHICS_DUE
                        - DEMOGRAPHICS_REVIEW
                      - type: 'null'
                      description: Narrow to submissions in one status.
                    userId:
                      anyOf:
                      - type: string
                        format: uuid
                      - type: 'null'
                      description: Narrow to one creator, by their Airaa user id.
                  required:
                  - projectCampaignId
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectCampaignId: c14e7b90-5a23-4f81-b6d7-90e3ac215f42
                limit: 10
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      submissions:
                        type: array
                        items:
                          $ref: '#/components/schemas/BountySubmission'
                      metadata:
                        $ref: '#/components/schemas/Metadata'
                      campaignType:
                        type: string
                    required:
                    - submissions
                    - metadata
                required:
                - result
              examples:
                '200':
                  summary: One row per creator. username is the X handle; userUsername is the Airaa username.
                  value:
                    result:
                      campaignType: social
                      submissions:
                      - submissionId: e91c40a8-2b76-4d35-9107-c58a3e60fb27
                        userId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                        userUsername: marasolace
                        username: mara_writes
                        name: Mara S.
                        profileImageUrl: https://cdn.airaa.xyz/users/mara.jpg
                        profileId: b47e1f92-0c3d-4a56-91e8-73d0a6f4c218
                        followersCount: 18400
                        viewCount: 41200
                        initialViewCount: 0
                        currentViewCount: 41200
                        deltaViewCount: 41200
                        offerInfo: null
                        tokenAmount: '20.00'
                        auraPointsAmount: '150'
                        estimatedPayout: '20.00'
                        tasks:
                        - taskId: 48f0d2b7-6a19-4c53-b8e0-71c9a35d6f42
                          submissionId: e91c40a8-2b76-4d35-9107-c58a3e60fb27
                          taskType: QUOTE
                          taskUrl: https://x.com/mara_writes/status/1892047713004556801
                          submissionStatus: PAID
                          submissionReason: null
                          aiReview:
                            verdict: pass
                            score: 0.94
                          claimedAt: '2026-08-11T10:04:00.000Z'
                          submittedAt: '2026-08-11T13:47:22.000Z'
                          submissionContent:
                            url: https://x.com/mara_writes/status/1892047713004556801
                            externalId: '1892047713004556801'
                            text: the focus timer finally clicked for me
                            viewCount: 41200
                            replyCount: 38
                            favoriteCount: 612
                      - submissionId: 0a7d3f52-9e18-4b60-a4c7-2f36bd0951ec
                        userId: 2c8f45d1-6e93-40a7-b25c-1d3e9f7a6b08
                        userUsername: devonbuilds
                        username: devon.codes
                        name: Devon K.
                        profileImageUrl: https://cdn.airaa.xyz/users/devon.jpg
                        profileId: 6cf2a8d1-9b47-4e30-8c15-2fa9e70b3d84
                        followersCount: 5120
                        viewCount: 0
                        initialViewCount: 0
                        currentViewCount: 0
                        deltaViewCount: 0
                        offerInfo:
                          offerAmount: '20.00'
                          counterOfferAmount: '35.00'
                          offerStatus: BRAND_OFFERED
                        tokenAmount: '0'
                        auraPointsAmount: '0'
                        estimatedPayout: '20.00'
                        tasks:
                        - taskId: 48f0d2b7-6a19-4c53-b8e0-71c9a35d6f42
                          submissionId: 0a7d3f52-9e18-4b60-a4c7-2f36bd0951ec
                          taskType: QUOTE
                          taskUrl: null
                          submissionStatus: PENDING
                          submissionReason: null
                          aiReview: {}
                          claimedAt: '2026-08-26T08:15:31.000Z'
                          submittedAt: null
                          submissionContent:
                            url: null
                            externalId: null
                            text: null
                            viewCount: 0
                            replyCount: 0
                            favoriteCount: 0
                      metadata:
                        page: 1
                        limit: 10
                        totalItems: 56
                        totalPages: 6
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_video_campaign_submissions/execute:
    post:
      operationId: get_video_campaign_submissions
      summary: List video campaign submissions
      tags:
      - Submissions
      description: |-
        Which clips were submitted to this video campaign, what did they earn, and what is still owed?

        Video campaigns only, both clipping and UGC. One row per clip rather than per creator, so a creator who posted four clips is four rows. This is where the view counts, the payout ledger (`submissionActions`) and the demographics review live.

        The money and view fields do not mean what their names suggest: `tokenReward` is a configured rate, not an amount paid.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectCampaignId:
                      type: string
                      description: 'The campaign id, from `get_project_campaigns`. Must be a video campaign (`campaignType: "clipping"` or `"ugc"`).'
                    page:
                      type: integer
                      minimum: 1
                      default: 1
                      description: Page number, 1-indexed
                    limit:
                      type: integer
                      minimum: 1
                      maximum: 100
                      default: 10
                      description: Items per page, max 100
                    platformId:
                      anyOf:
                      - type: string
                        format: uuid
                      - type: 'null'
                      description: Narrow to clips posted on one platform. Platform ids come back on the campaign's tasks.
                    statusBy:
                      anyOf:
                      - type: string
                        enum:
                        - PENDING
                        - APPROVED
                        - FAILED
                        - PAID
                        - MILESTONE_BONUS_PAID
                        - DEMOGRAPHICS_DUE
                        - DEMOGRAPHICS_REVIEW
                      - type: 'null'
                      description: Narrow to submissions in one status.
                    sortBy:
                      anyOf:
                      - type: string
                        enum:
                        - views
                        - likes
                        - created_at
                      - type: 'null'
                      description: Order rows by paying views (`views`), likes, or submission time.
                    sortOrder:
                      anyOf:
                      - type: string
                        enum:
                        - ASC
                        - DESC
                      - type: 'null'
                      description: Sort order
                  required:
                  - projectCampaignId
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectCampaignId: a7d2f61c-08b5-4e3a-9c14-5f8b73d20e69
                sortBy: views
                sortOrder: DESC
                limit: 10
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      rows:
                        type: array
                        items:
                          $ref: '#/components/schemas/VideoSubmission'
                      budget:
                        type: object
                        properties:
                          remainingPool:
                            type:
                            - string
                            - 'null'
                            description: Budget not yet committed. Decimal string.
                          accruedUnpaid:
                            type:
                            - string
                            - 'null'
                            description: Owed across all rows but not yet sent. Decimal string.
                      metadata:
                        $ref: '#/components/schemas/Metadata'
                    required:
                    - rows
                    - metadata
                required:
                - result
              examples:
                '200':
                  summary: 'videoUrl and demographicsVideoUrl are creator-uploaded files on the Airaa CDN: the archived clip, and the creator''s screen recording of their audience demographics. Both are private to the brand; do not share the links outside it.'
                  value:
                    result:
                      rows:
                      - submissionId: b52f8c14-70a3-49de-81b6-3c0f7a95e2d8
                        taskId: 7b3e19a2-c845-4d70-9e16-a2f5c80b31d4
                        platformId: f0a4c927-51d8-4b63-9a72-e8d1c3406b5f
                        platformName: TikTok
                        platformSlug: tiktok
                        creatorUserId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                        creatorUsername: marasolace
                        creatorPhotoUrl: https://cdn.airaa.xyz/users/mara.jpg
                        followersCount: 18400
                        status: PAID
                        rejectionReason: null
                        submittedAt: '2026-08-09T18:22:05.000Z'
                        expiresAt: '2099-01-01T00:00:00.000Z'
                        contentId: c806b3e9-1d47-4a90-8b23-e5f0742c169b
                        contentUrl: https://www.tiktok.com/@mara.clips/video/7401882910345
                        contentTitle: the two-second hook that sold me
                        thumbnailUrl: https://cdn.airaa.xyz/submissions/b52f8c14/thumb.jpg
                        videoUrl: https://cdn.airaa.xyz/submissions/b52f8c14/clip.mp4
                        commentCount: 402
                        engagement:
                          views: 312800
                          initialViews: 1200
                          currentViews: 314000
                          deltaViews: 312800
                          likes: 24100
                          comments: 402
                        estimatedPayout: '0'
                        tokenReward: '0'
                        auraPointsReward: '400'
                        basePaidAmount: '437.92'
                        bonusPaidAmount: '50.00'
                        totalPaidAmount: '487.92'
                        cumulativePaidAmount: '487.92'
                        lastPaidAt: '2026-08-25T06:00:11.000Z'
                        accruedUnpaid: '0'
                        accruedBaseAmount: '0'
                        accruedBonusAmount: '0'
                        maxPayoutPerClip: 250
                        submissionActions:
                        - actionType: MILESTONE_BONUS_PAID
                          amount: '50.00'
                          viewsSnapshot: 314000
                          deltaViews: 312800
                          reason: 100k view milestone
                          createdAt: '2026-08-25T06:00:11.000Z'
                        - actionType: PAID
                          amount: '437.92'
                          viewsSnapshot: 314000
                          deltaViews: 312800
                          reason: null
                          createdAt: '2026-08-25T06:00:10.000Z'
                        - actionType: APPROVED
                          amount: null
                          viewsSnapshot: 1200
                          deltaViews: 0
                          reason: null
                          createdAt: '2026-08-09T19:40:02.000Z'
                        demographicsVideoUrl: https://cdn.airaa.xyz/demographics/b52f8c14/proof.mp4
                        demographicsReviewResult: APPROVED
                      - submissionId: 1f47e0b6-8d92-4a53-b7c0-e51947d3628a
                        taskId: 7b3e19a2-c845-4d70-9e16-a2f5c80b31d4
                        platformId: f0a4c927-51d8-4b63-9a72-e8d1c3406b5f
                        platformName: TikTok
                        platformSlug: tiktok
                        creatorUserId: 2c8f45d1-6e93-40a7-b25c-1d3e9f7a6b08
                        creatorUsername: devonbuilds
                        creatorPhotoUrl: https://cdn.airaa.xyz/users/devon.jpg
                        followersCount: 5120
                        status: APPROVED
                        rejectionReason: null
                        submittedAt: '2026-08-24T11:03:40.000Z'
                        expiresAt: null
                        contentId: 4a19f7c3-62b8-4e01-9d75-8f30c4e12ba6
                        contentUrl: https://www.tiktok.com/@devon.codes/video/7409113277001
                        contentTitle: 3 settings I changed on day one
                        thumbnailUrl: https://cdn.airaa.xyz/submissions/1f47e0b6/thumb.jpg
                        videoUrl: https://cdn.airaa.xyz/submissions/1f47e0b6/clip.mp4
                        commentCount: 27
                        engagement:
                          views: 18600
                          initialViews: 400
                          currentViews: 19000
                          deltaViews: 18600
                          likes: 1340
                          comments: 27
                        estimatedPayout: '26.04'
                        tokenReward: '0'
                        auraPointsReward: '0'
                        basePaidAmount: '0'
                        bonusPaidAmount: '0'
                        totalPaidAmount: '0'
                        cumulativePaidAmount: '0'
                        lastPaidAt: null
                        accruedUnpaid: '26.04'
                        accruedBaseAmount: '26.04'
                        accruedBonusAmount: '0'
                        maxPayoutPerClip: 250
                        submissionActions:
                        - actionType: APPROVED
                          amount: null
                          viewsSnapshot: 400
                          deltaViews: 0
                          reason: null
                          createdAt: '2026-08-24T12:11:09.000Z'
                        demographicsVideoUrl: null
                        demographicsReviewResult: null
                      budget:
                        remainingPool: '7420.15'
                        accruedUnpaid: '612.40'
                      metadata:
                        page: 1
                        limit: 10
                        totalItems: 128
                        totalPages: 13
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_project_members_detailed/execute:
    post:
      operationId: get_project_members_detailed
      summary: List community members
      tags:
      - People
      description: |-
        Who is in this community?

        The member roster with profile info, connected platforms, follower totals and per-community participation stats. Defaults to `ACTIVE` members. Filtering to any other status requires you to be an admin or moderator of that community.

        Returns a bare array with no `metadata`, so nothing in the response tells you whether more pages exist. Page until a request returns fewer rows than `limit`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectId:
                      type:
                      - string
                      - 'null'
                      description: The community id, from `list_manageable_projects`.
                    status:
                      anyOf:
                      - type: string
                        enum:
                        - ACTIVE
                        - INACTIVE
                        - PENDING
                        - SUSPENDED
                      - type: 'null'
                      description: Narrow to one membership status. Defaults to `ACTIVE`. Any other value requires you to be an admin or moderator of the community.
                    page:
                      type: integer
                      minimum: 1
                      default: 1
                      description: Page number, 1-indexed
                    limit:
                      type: integer
                      minimum: 1
                      maximum: 100
                      default: 50
                      description: Items per page, max 100
                    role:
                      anyOf:
                      - type: string
                        enum:
                        - MEMBER
                        - MODERATOR
                        - ADMIN
                      - type: 'null'
                      description: Narrow to one role. Omit to include every role.
                    niche:
                      anyOf:
                      - type: string
                        enum:
                        - Gaming
                        - Lifestyle
                        - Fashion
                        - Beauty
                        - Fitness
                        - Food
                        - Travel
                        - Music
                        - Sports
                        - Tech
                        - Finance
                        - Education
                        - Entertainment
                        - Comedy
                        - Art & Design
                        - Creator
                        - Crypto
                        - Business
                      - type: 'null'
                      description: Narrow to members tagged with one niche. Omit to include every niche.
                    platforms:
                      type:
                      - string
                      - 'null'
                      description: 'Narrow to members who connected these platforms, comma-separated. Valid slugs: `x`, `instagram`, `youtube`.'
                    search:
                      type:
                      - string
                      - 'null'
                      description: Search by name or username
                  additionalProperties: false
                  required:
                  - projectId
              required:
              - args
            example:
              args:
                projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                limit: 50
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/Member'
                required:
                - result
              examples:
                '200':
                  summary: A bare array with no metadata, so page until you get fewer rows than limit.
                  value:
                    result:
                    - userId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                      username: marasolace
                      name: Mara S.
                      photoUrl: https://cdn.airaa.xyz/users/mara.jpg
                      status: ACTIVE
                      role: MEMBER
                      niche:
                      - Tech
                      - Lifestyle
                      locationCountry: United States
                      platforms:
                      - slug: tiktok
                        handle: mara.clips
                        followersCount: 24400
                      - slug: x
                        handle: mara_writes
                        followersCount: 18400
                      totalFollowers: 42800
                      communityCampaignsParticipated: 6
                      totalCommunityImpressions: 1284000
                      tags:
                      - top-performer
                    - userId: 2c8f45d1-6e93-40a7-b25c-1d3e9f7a6b08
                      username: devonbuilds
                      name: Devon K.
                      photoUrl: https://cdn.airaa.xyz/users/devon.jpg
                      status: ACTIVE
                      role: MODERATOR
                      niche:
                      - Tech
                      locationCountry: United Kingdom
                      platforms:
                      - slug: tiktok
                        handle: devon.codes
                        followersCount: 5120
                      totalFollowers: 5120
                      communityCampaignsParticipated: 2
                      totalCommunityImpressions: 41800
                      tags: []
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_project_earnings_leaderboard/execute:
    post:
      operationId: get_project_earnings_leaderboard
      summary: Get the earnings leaderboard
      tags:
      - People
      description: |-
        Who earned the most in this community over a date range?

        Every row carries `totalViews`, `totalCampaigns`, `totalUsdc` and `totalCommunityToken` regardless of what you sort by. `sortBy` only orders the rows; it does not change what they contain.

        There is no sort-by-views option: page the range with `metadata.totalPages` and re-rank the combined rows yourself. Setting `myRank: true` returns only your own row and ignores `page`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectId:
                      type:
                      - string
                      - 'null'
                      description: The community id, from `list_manageable_projects`.
                    startDate:
                      type: string
                      description: Start date inclusive (YYYY-MM-DD)
                    endDate:
                      type: string
                      description: End date inclusive (YYYY-MM-DD), must be on/after startDate
                    sortBy:
                      type: string
                      enum:
                      - USDC
                      - POINTS
                      description: 'Which total to rank on. Does not change what a row contains: every row carries both USDC and points regardless.'
                    page:
                      anyOf:
                      - type: integer
                        minimum: 1
                      - type: 'null'
                      description: Page number, 1-indexed
                    myRank:
                      type:
                      - boolean
                      - 'null'
                      description: Return only the key owner's own row for this range. Ignores `page`.
                  required:
                  - startDate
                  - endDate
                  - sortBy
                  - projectId
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                startDate: '2026-08-01'
                endDate: '2026-08-28'
                sortBy: USDC
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/LeaderboardRow'
                      metadata:
                        $ref: '#/components/schemas/Metadata'
                required:
                - result
              examples:
                '200':
                  summary: Here username is the Airaa username. Platform handles are in socialConnections.
                  value:
                    result:
                      data:
                      - rank: 1
                        username: marasolace
                        name: Mara S.
                        photoUrl: https://cdn.airaa.xyz/users/mara.jpg
                        socialConnections:
                        - platformId: f0a4c927-51d8-4b63-9a72-e8d1c3406b5f
                          platformName: TikTok
                          externalUsername: mara.clips
                        totalCampaigns: 4
                        totalViews: 892400
                        totalUsdc: '1284.60'
                        totalCommunityToken: '18400'
                      - rank: 2
                        username: devonbuilds
                        name: Devon K.
                        photoUrl: https://cdn.airaa.xyz/users/devon.jpg
                        socialConnections:
                        - platformId: f0a4c927-51d8-4b63-9a72-e8d1c3406b5f
                          platformName: TikTok
                          externalUsername: devon.codes
                        totalCampaigns: 2
                        totalViews: 41800
                        totalUsdc: '96.20'
                        totalCommunityToken: '2100'
                      metadata:
                        page: 1
                        limit: 100
                        totalItems: 214
                        totalPages: 3
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_user_info/execute:
    post:
      operationId: get_user_info
      summary: Get user info
      tags:
      - Account
      description: |-
        Which account is this key acting as?

        The key owner's own profile: name, username, bio, niches, connected social accounts, X profile details, wallets, primary wallet address and display country.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties: {}
                  additionalProperties: false
              required:
              - args
            example:
              args: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/UserInfo'
                required:
                - result
              examples:
                '200':
                  value:
                    result:
                      id: d3b71f68-92a4-4c05-8e37-6b1902ac4f5d
                      email: priya@lumenlabs.com
                      name: Priya R.
                      username: priyanotes
                      bio: Building Lumen Labs.
                      photoUrl: https://cdn.airaa.xyz/users/priya.jpg
                      twitterProfileId: aa10f39c-6d54-4b82-9e07-1c8b45a2f36d
                      profile:
                        id: aa10f39c-6d54-4b82-9e07-1c8b45a2f36d
                        externalId: '1487200364115738624'
                        name: Priya R.
                        username: priyanotes
                        url: https://x.com/priyanotes
                        description: Building Lumen Labs.
                        profileImageUrl: https://cdn.airaa.xyz/users/priya-x.jpg
                        followersCount: 12400
                        followingCount: 641
                        profileCreatedAt: '2022-01-29T11:04:00.000Z'
                        contentCount: 3182
                        accountBasedIn: United States
                      userNiche:
                      - Tech
                      - Business
                      primaryWalletAddress: '0x7a2f19c48b0d6e35a1c9f803b7e24d6015c8ab39'
                      totalBalance: '8412.77'
                      wallets:
                      - address: '0x7a2f19c48b0d6e35a1c9f803b7e24d6015c8ab39'
                        type: EVM
                        isPrimary: true
                        projectSlug: null
                        updatedAt: '2026-08-19T07:41:52.000Z'
                      accounts:
                      - platformId: 6e2c81b4-3f97-40da-85c1-b70d924ef3a8
                        platformName: Twitter/X
                        externalId: '1487200364115738624'
                        externalUsername: priyanotes
                        connectedAt: '2026-02-14T09:20:00.000Z'
                      location:
                        country: United States
                        countryCode: US
                      isAiraaCreator: false
                      createdAt: '2026-02-14T09:18:31.000Z'
                      updatedAt: '2026-08-19T07:41:52.000Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_tokens/execute:
    post:
      operationId: get_tokens
      summary: List payout tokens
      tags:
      - Account
      description: |-
        What tokens can campaigns pay out in?

        Active payout tokens, of two kinds: `ERC20` tokens paid on-chain, and `POINTS` tokens a community mints for itself. Setting `projectId` returns that community's token and causes the `type` filter to be ignored. Sending neither argument returns every active token.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    type:
                      anyOf:
                      - type: string
                        enum:
                        - ERC20
                        - POINTS
                      - type: 'null'
                      description: Token type to fetch. Ignored when `projectId` is set.
                    projectId:
                      type:
                      - string
                      - 'null'
                      description: The community id. Narrows the result to that community's token, and causes the `type` filter to be ignored.
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/PayoutToken'
                required:
                - result
              examples:
                '200':
                  value:
                    result:
                    - id: 5c1a908e-47b3-4f26-90d8-e2f74b613a05
                      symbol: USDC
                      name: USD Coin
                      logo: https://cdn.airaa.xyz/tokens/usdc.png
                      address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                      chainId: '8453'
                      decimals: 6
                      status: ACTIVE
                      type: ERC20
                    - id: b6c0e83f-4a71-4d92-8e15-3c7f9021ba64
                      symbol: LUMEN
                      name: Lumen Points
                      logo: https://cdn.airaa.xyz/tokens/lumen.png
                      address: null
                      chainId: null
                      decimals: 0
                      status: ACTIVE
                      type: POINTS
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_current_datetime/execute:
    post:
      operationId: get_current_datetime
      summary: Get the server clock
      tags:
      - Account
      description: |-
        What time is it on the server?

        The current date and time in UTC, or in any IANA timezone you name. Useful for building the `startDate` and `endDate` range that `get_project_earnings_leaderboard` requires.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    timezone:
                      type:
                      - string
                      - 'null'
                      default: UTC
                      description: IANA timezone name (e.g. "America/New_York"). Defaults to UTC when not provided.
                  additionalProperties: false
              required:
              - args
            example:
              args:
                timezone: America/New_York
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      datetime:
                        type: string
                      timezone:
                        type: string
                required:
                - result
              examples:
                '200':
                  value:
                    result:
                      datetime: '2026-08-28T09:14:02.000-04:00'
                      timezone: America/New_York
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_chat_threads/execute:
    post:
      operationId: get_chat_threads
      summary: List chat threads
      tags:
      - Chat
      description: |-
        Who has been messaging this community, and who is waiting on a reply?

        One community's chat inbox, the same list the dashboard shows a brand: one thread per creator who has messaged or submitted there. Each thread carries the creator's identity, a preview of the last message, and two counts. Take `creatorUserId` from a thread here and pass it to `get_chat_messages` to read the conversation.

        `projectId` is required. This tool only ever reads a community you administer; it never reads the key owner's own creator inbox.

        `unreadCount` is messages the brand has not opened. `pendingReviewCount` is submissions from that creator awaiting review, not messages at all.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectId:
                      type: string
                      description: The community whose inbox to read, from `list_manageable_projects`.
                    projectCampaignId:
                      type:
                      - string
                      - 'null'
                      description: Only threads with a non-rejected submission in this campaign
                    search:
                      type:
                      - string
                      - 'null'
                      description: Matches creator name/username, project name and campaign titles
                    onlyPendingReview:
                      type:
                      - boolean
                      - 'null'
                      description: Only threads with submissions awaiting review
                    page:
                      type: integer
                      minimum: 1
                      default: 1
                      description: Page number, 1-indexed
                    limit:
                      type: integer
                      minimum: 1
                      maximum: 100
                      default: 20
                      description: Threads per page, max 100
                  required:
                  - projectId
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                limit: 20
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      threads:
                        type: array
                        items:
                          $ref: '#/components/schemas/ChatThread'
                      page:
                        type: integer
                      limit:
                        type: integer
                      hasMore:
                        type: boolean
                    required:
                    - threads
                required:
                - result
              examples:
                '200':
                  summary: pendingReviewCount is submissions awaiting review, not unread messages. Paginates with page/limit/hasMore rather than a metadata object.
                  value:
                    result:
                      threads:
                      - creatorUserId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                        projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        username: marasolace
                        userDisplayName: Mara S.
                        userPhotoUrl: https://cdn.airaa.xyz/users/mara.jpg
                        lastMessagePreview: sent the second cut, let me know if the hook lands
                        lastMessageType: text
                        lastMessageAt: '2026-08-27T16:42:19.000Z'
                        unreadCount: 2
                        pendingReviewCount: 1
                      - creatorUserId: 2c8f45d1-6e93-40a7-b25c-1d3e9f7a6b08
                        projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                        username: devonbuilds
                        userDisplayName: Devon K.
                        userPhotoUrl: https://cdn.airaa.xyz/users/devon.jpg
                        lastMessagePreview: Submission received for Launch week clips
                        lastMessageType: system
                        lastMessageAt: '2026-08-24T11:03:40.000Z'
                        unreadCount: 0
                        pendingReviewCount: 0
                      page: 1
                      limit: 20
                      hasMore: true
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
  /api/ai/mcp/tools/get_chat_messages/execute:
    post:
      operationId: get_chat_messages
      summary: Read a chat thread
      tags:
      - Chat
      description: |-
        What did this creator and the brand actually say to each other?

        One creator's thread inside one community, oldest message first. Both `projectId` and `creatorUserId` are required; take `creatorUserId` from `get_chat_threads`.

        This returns a bare array rather than a paginated envelope. Page with the `before` and `after` ISO timestamps rather than `page` and `limit` offsets: `before` walks further back through history, `after` catches up on what arrived since.

        Read-only. There is no way to send a message, mark the thread read, or delete anything through the API.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    projectId:
                      type: string
                      description: The community the thread belongs to.
                    creatorUserId:
                      type: string
                      description: The creator whose thread to read, from `get_chat_threads`.
                    projectCampaignId:
                      type:
                      - string
                      - 'null'
                      description: Scopes the lookup to one campaign, for threads that belong to a campaign rather than to the community at large.
                    limit:
                      type: integer
                      minimum: 1
                      maximum: 100
                      default: 50
                      description: Messages per page, max 100
                    before:
                      type:
                      - string
                      - 'null'
                      description: ISO timestamp. Returns only messages older than this.
                    after:
                      type:
                      - string
                      - 'null'
                      description: ISO timestamp. Returns only messages newer than this.
                  required:
                  - projectId
                  - creatorUserId
                  additionalProperties: false
              required:
              - args
            example:
              args:
                projectId: 3f2a9c7e-1b84-4d5a-9e60-7c1af2b83d41
                creatorUserId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                limit: 50
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/ChatMessage'
                required:
                - result
              examples:
                '200':
                  summary: A bare array, oldest first. These are private messages between the brand and the creator; media and videoUrl are creator-uploaded files on the Airaa CDN and should not be shared outside the brand.
                  value:
                    result:
                    - id: 9c04b7e2-3a15-4d68-b029-71f5e8c34ab6
                      creatorUserId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                      projectCampaignId: a7d2f61c-08b5-4e3a-9c14-5f8b73d20e69
                      campaignTitle: Launch week clips
                      senderType: airaa
                      senderDisplayName: null
                      senderUsername: null
                      senderPhotoUrl: null
                      messageType: system
                      content: Mara S. claimed a TikTok slot on Launch week clips.
                      media: {}
                      videoUrl: null
                      replyToMessageId: null
                      replyToMessage: null
                      isReadByBrand: true
                      isReadByCreator: true
                      createdAt: '2026-08-09T18:20:41.000Z'
                    - id: d17e5f80-64c9-4b23-a05e-8f21c740b93d
                      creatorUserId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                      projectCampaignId: a7d2f61c-08b5-4e3a-9c14-5f8b73d20e69
                      campaignTitle: Launch week clips
                      senderType: creator
                      senderDisplayName: Mara S.
                      senderUsername: marasolace
                      senderPhotoUrl: https://cdn.airaa.xyz/users/mara.jpg
                      messageType: draft_submission
                      content: first cut, hook is at 0:02
                      media: {}
                      videoUrl: https://cdn.airaa.xyz/submissions/b52f8c14/clip.mp4
                      replyToMessageId: null
                      replyToMessage: null
                      isReadByBrand: true
                      isReadByCreator: true
                      createdAt: '2026-08-09T18:22:05.000Z'
                    - id: 3b8a24d6-f051-4e97-8c16-2a5d90e7cb48
                      creatorUserId: 5e9c1a47-3d20-4b68-9f15-8c7e2a04d3b1
                      projectCampaignId: a7d2f61c-08b5-4e3a-9c14-5f8b73d20e69
                      campaignTitle: Launch week clips
                      senderType: brand
                      senderDisplayName: Priya R.
                      senderUsername: priyanotes
                      senderPhotoUrl: https://cdn.airaa.xyz/users/priya.jpg
                      messageType: text
                      content: hook works, approved.
                      media: {}
                      videoUrl: null
                      replyToMessageId: d17e5f80-64c9-4b23-a05e-8f21c740b93d
                      replyToMessage:
                        id: d17e5f80-64c9-4b23-a05e-8f21c740b93d
                        senderType: creator
                        senderDisplayName: Mara S.
                        senderUsername: marasolace
                        messageType: draft_submission
                        content: first cut, hook is at 0:02
                        media: {}
                      isReadByBrand: true
                      isReadByCreator: true
                      createdAt: '2026-08-09T19:40:02.000Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: An `airaa_` key from Profile -> API key. Send it in the Authorization header, never in a URL.
  responses:
    BadRequest:
      description: An argument is missing or failed validation; the message names the field. Also returned when a required projectId is omitted.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: The key is missing or not valid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The key is valid but you do not administer that community.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: No such tool, or no campaign with that id.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Too many requests. Tool execution is limited to 120 calls per minute per user.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    PointsToken:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        symbol:
          type: string
        logo:
          type:
          - string
          - 'null'
      description: A community's own points token.
    ManageableProject:
      type: object
      properties:
        projectId:
          type: string
          format: uuid
        slug:
          type: string
        name:
          type: string
        role:
          type: string
          description: Your role in this community.
          enum:
          - ADMIN
          - MODERATOR
        logo:
          type:
          - string
          - 'null'
        pointsToken:
          oneOf:
          - $ref: '#/components/schemas/PointsToken'
          - type: 'null'
        campaignCommission:
          type:
          - integer
          - 'null'
          description: Platform commission percentage applied to this community.
      required:
      - projectId
      - slug
      - name
      - role
    TokenTotal:
      type: object
      properties:
        totalAmount:
          type:
          - string
          - 'null'
          description: Total distributed. Decimal string.
        symbol:
          type: string
        decimals:
          type: integer
    TeamMember:
      type: object
      properties:
        userId:
          type: string
          format: uuid
        role:
          type: string
          enum:
          - MEMBER
          - MODERATOR
          - ADMIN
        photoUrl:
          type:
          - string
          - 'null'
        username:
          type:
          - string
          - 'null'
        name:
          type:
          - string
          - 'null'
    CommunitySocials:
      type: object
      properties:
        web:
          type:
          - string
          - 'null'
        twitter:
          type:
          - string
          - 'null'
        telegram:
          type:
          - string
          - 'null'
        discord:
          type:
          - string
          - 'null'
        youtube:
          type:
          - string
          - 'null'
        instagram:
          type:
          - string
          - 'null'
        tiktok:
          type:
          - string
          - 'null'
      description: Only the platforms the community has connected are present.
    ProjectInfo:
      type: object
      properties:
        id:
          type: string
          format: uuid
        slug:
          type: string
        name:
          type: string
        isWhitelabelEnabled:
          type: boolean
        category:
          type:
          - string
          - 'null'
        logo:
          type:
          - string
          - 'null'
        banner:
          type:
          - string
          - 'null'
        description:
          type:
          - string
          - 'null'
        twitterProfileUrl:
          type:
          - string
          - 'null'
          description: X profile URL. Same value as socials.x.
        totalMemberCount:
          type: integer
        activeMembersCount:
          type: integer
        isUserMember:
          type: boolean
        userMembershipStatus:
          type:
          - string
          - 'null'
          enum:
          - ACTIVE
          - INACTIVE
          - PENDING
          - SUSPENDED
          - null
        userRole:
          type:
          - string
          - 'null'
          enum:
          - MEMBER
          - MODERATOR
          - ADMIN
          - null
        activeCampaignsCount:
          type: integer
        totalCampaignsCount:
          type: integer
        rewardsDistributed:
          type:
          - string
          - 'null'
          description: Total ERC20 value paid out across all campaigns. Decimal string.
        totalPointsDistributed:
          type:
          - string
          - 'null'
          description: Total community points awarded. Decimal string.
        erc20Totals:
          type: array
          items:
            $ref: '#/components/schemas/TokenTotal'
        pointsTotals:
          type: array
          items:
            $ref: '#/components/schemas/TokenTotal'
        teamMembers:
          type: array
          items:
            $ref: '#/components/schemas/TeamMember'
        twitterFollowersCount:
          type: integer
        pointsToken:
          oneOf:
          - type: object
            properties:
              symbol:
                type: string
              logo:
                type:
                - string
                - 'null'
          - type: 'null'
        socials:
          $ref: '#/components/schemas/CommunitySocials'
        pendingActions:
          type: object
          properties:
            gigApplications:
              $ref: '#/components/schemas/PendingAction'
            joinRequests:
              $ref: '#/components/schemas/PendingAction'
          description: 'Queues waiting on an admin: creators who applied to a gig, and people who asked to join the community. Each carries a count and the first few rows.'
    PendingAction:
      type: object
      properties:
        count:
          type: integer
        preview:
          type: array
          items:
            type: object
            properties:
              userId:
                type: string
                format: uuid
              username:
                type:
                - string
                - 'null'
              photoUrl:
                type:
                - string
                - 'null'
    PayoutToken:
      type: object
      properties:
        id:
          type: string
          format: uuid
        symbol:
          type: string
        name:
          type: string
        logo:
          type:
          - string
          - 'null'
        address:
          type:
          - string
          - 'null'
          description: ERC20 contract address. Null for POINTS tokens.
        chainId:
          type:
          - string
          - 'null'
          description: EVM chain id as a string. Null for POINTS tokens.
        decimals:
          type: integer
        status:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
        type:
          type: string
          enum:
          - ERC20
          - POINTS
    TwitterProfile:
      type: object
      properties:
        id:
          type: string
          format: uuid
        externalId:
          type: string
          description: X numeric user id.
        name:
          type:
          - string
          - 'null'
        username:
          type:
          - string
          - 'null'
        url:
          type:
          - string
          - 'null'
        description:
          type:
          - string
          - 'null'
        profileImageUrl:
          type:
          - string
          - 'null'
        followersCount:
          type: integer
        followingCount:
          type: integer
        profileCreatedAt:
          type: string
          format: date-time
        contentCount:
          type: integer
        accountBasedIn:
          type:
          - string
          - 'null'
          description: Country X reports for the account. Read from the X API, not set in Airaa.
    Wallet:
      type: object
      properties:
        address:
          type: string
        type:
          type: string
          enum:
          - EVM
          - SOLANA
          - ALGORAND
        isPrimary:
          type: boolean
        projectSlug:
          type:
          - string
          - 'null'
        updatedAt:
          type: string
          format: date-time
    ConnectedAccount:
      type: object
      properties:
        platformId:
          type: string
          description: Opaque platform id. Pass to get_video_campaign_submissions.platformId.
          format: uuid
        platformName:
          type: string
          enum:
          - Twitter/X
          - Instagram
          - TikTok
          - YouTube
        externalId:
          type: string
        externalUsername:
          type:
          - string
          - 'null'
        connectedAt:
          type: string
          format: date-time
    UserLocation:
      type: object
      properties:
        country:
          type:
          - string
          - 'null'
        countryCode:
          type:
          - string
          - 'null'
      description: Display country only, from the last known request IP.
    UserInfo:
      type: object
      properties:
        id:
          type: string
          format: uuid
        email:
          type:
          - string
          - 'null'
        name:
          type:
          - string
          - 'null'
        username:
          type: string
        bio:
          type:
          - string
          - 'null'
        photoUrl:
          type:
          - string
          - 'null'
        twitterProfileId:
          type:
          - string
          - 'null'
          format: uuid
          description: Id of the connected X profile, the same value as `profile.id`.
        profile:
          oneOf:
          - $ref: '#/components/schemas/TwitterProfile'
          - type: 'null'
        userNiche:
          type: array
          items:
            type: string
          description: Niches the key owner picked during onboarding or later on their profile page.
        primaryWalletAddress:
          type:
          - string
          - 'null'
        totalBalance:
          type:
          - string
          - 'null'
          description: Portfolio value across wallets. Decimal string.
        wallets:
          type: array
          items:
            $ref: '#/components/schemas/Wallet'
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/ConnectedAccount'
        location:
          oneOf:
          - $ref: '#/components/schemas/UserLocation'
          - type: 'null'
        isAiraaCreator:
          type: boolean
          description: True if this account is listed under Airaa certified creators when a brand picks who can join a campaign.
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    CampaignPlatform:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        enabled:
          type: boolean
    CampaignListItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        status:
          type: string
          enum:
          - DRAFT
          - LIVE
          - ENDED
          - PAUSED
          - PAYMENT_PENDING
          - PAYMENT_PROCESSING
        campaignType:
          type: string
          description: '`social` is a bounty campaign; `clipping` and `ugc` are video campaigns.'
          enum:
          - social
          - clipping
          - ugc
          - milestone
          - standard
          - onchain
        taskTypes:
          type: array
          items:
            type: string
          description: 'One entry per task on the campaign. Bounty tasks are `POST`, `QUOTE`, `REPLY` or `FOLLOW`. Video tasks name the platform too: `CLIP_X`, `CLIP_TIKTOK`, `CLIP_INSTAGRAM`.'
        totalPool:
          type:
          - string
          - 'null'
          description: Budget for this campaign. Decimal string.
        remainingPool:
          type:
          - string
          - 'null'
          description: Budget not yet committed. Decimal string.
        usedBudget:
          type:
          - string
          - 'null'
          description: Budget already paid out. Decimal string.
        platform:
          type: array
          items:
            $ref: '#/components/schemas/CampaignPlatform'
        payoutType:
          type: string
          enum:
          - ''
          - FCFS
          - OFFERS
        tokenType:
          type: string
          enum:
          - ERC20
          - POINTS
        tokenSymbol:
          type: string
        completedUsersCount:
          type: integer
        incompletedUsersCount:
          type: integer
        hasCounterOffer:
          type: boolean
          description: A creator has countered the offer on this campaign. Counter-offers always come from the creator, never from the brand.
        approvedClipsCount:
          type: integer
          description: Video campaigns only.
        impressions:
          type: integer
          description: Total views across approved submissions.
        pendingReviewsCount:
          type: integer
        project:
          type: object
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            logo:
              type:
              - string
              - 'null'
        createdAt:
          type: string
          format: date-time
    CampaignCounts:
      type: object
      properties:
        live:
          type: integer
        draft:
          type: integer
        ended:
          type: integer
        spent:
          type: number
          description: Total paid out across the counted campaigns.
      description: Aggregate totals. get_project_campaigns returns this instead of a `metadata` object.
    SubmissionRequirements:
      type: object
      properties:
        guidelines:
          type:
          - string
          - 'null'
        hashtags:
          type: object
          properties:
            values:
              type: array
              items:
                type: string
            isEnabled:
              type: boolean
            requireAll:
              type: boolean
        mentions:
          type: object
          properties:
            values:
              type: array
              items:
                type: string
            isEnabled:
              type: boolean
            requireAll:
              type: boolean
        urls:
          type: object
          properties:
            values:
              type: array
              items:
                type: string
            isEnabled:
              type: boolean
            requireAll:
              type: boolean
    BonusRange:
      type: object
      properties:
        views:
          type: integer
          description: View milestone.
        amount:
          type: number
          description: Bonus paid on reaching it.
    Budget:
      type: object
      properties:
        totalPool:
          type:
          - string
          - 'null'
          description: Campaign budget. Decimal string.
        remainingPool:
          type:
          - string
          - 'null'
          description: Budget not yet committed. Decimal string.
        tokenType:
          type: string
          enum:
          - ERC20
          - POINTS
        tokenSymbol:
          type: string
        tokenAddress:
          type:
          - string
          - 'null'
        chainId:
          type:
          - string
          - 'null'
        decimals:
          type: integer
    CampaignDetail:
      type: object
      properties:
        campaignType:
          type: string
          enum:
          - social
          - clipping
          - ugc
        detailVariant:
          type: string
          description: '`social_owner` for bounty campaigns and any draft; `clipping_owner` for non-draft video campaigns. Tells you which of the two shapes came back.'
          enum:
          - social_owner
          - clipping_owner
        campaign:
          type: object
          properties:
            id:
              type: string
              format: uuid
            projectId:
              type: string
              format: uuid
            title:
              type: string
            status:
              type: string
            type:
              type: string
            imageUrl:
              type:
              - string
              - 'null'
            startDate:
              type: string
              format: date-time
            endDate:
              type:
              - string
              - 'null'
              format: date-time
            createdAt:
              type: string
              format: date-time
            approvalMode:
              type: string
              enum:
              - MANUAL
              - AI
            needsDraft:
              type: boolean
              description: Creators must submit a draft for approval before posting.
            userEligibilityCriteria:
              type: object
              properties: {}
              additionalProperties: true
        project:
          type: object
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            slug:
              type: string
            logo:
              type:
              - string
              - 'null'
        stats:
          type: object
          properties:
            creators:
              type: integer
            reach:
              type: integer
            likes:
              type: integer
            quotes:
              type: integer
              description: Quote posts for this campaign. Zero on TikTok and Instagram campaigns, which have no quotes.
            post:
              type: integer
              description: Posts published for this campaign.
        budget:
          $ref: '#/components/schemas/Budget'
        tasks:
          type: array
          items:
            type: object
            properties: {}
            description: Populated on the social_owner variant.
            additionalProperties: true
        clippingOwner:
          oneOf:
          - $ref: '#/components/schemas/ClippingOwnerDetail'
          - type: 'null'
          description: Null on the social_owner variant.
        campaignCommission:
          type:
          - integer
          - 'null'
          description: Platform commission percentage for this campaign.
        draftConfig:
          type:
          - object
          - 'null'
          additionalProperties: true
        eligibilityProject:
          type:
          - object
          - 'null'
          additionalProperties: true
    ClippingOwnerDetail:
      type: object
      properties:
        demographicsRequired:
          type: boolean
          description: Creators must upload proof of audience demographics.
        demographicsAudienceRule:
          type:
          - string
          - 'null'
          description: The audience a creator has to prove, as written when the campaign was set up. Free text, not a rule you can parse.
        eligibilitySummary:
          type: object
          properties:
            mode:
              type: string
              enum:
              - open
              - guild
              description: '`open` when anyone can join. `guild` when only one community can.'
            guild:
              oneOf:
              - type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  name:
                    type: string
                  logo:
                    type:
                    - string
                    - 'null'
              - type: 'null'
              description: The community the campaign is limited to. Null when `mode` is `open`.
        overview:
          type: object
          properties:
            creatorsCount:
              type: integer
            totalSubmissionsCount:
              type: integer
            submissionsCount:
              type: integer
            pendingSubmissionsCount:
              type: integer
            approvedSubmissionsCount:
              type: integer
            rejectedSubmissionsCount:
              type: integer
            paidSubmissionsCount:
              type: integer
            reach:
              type: integer
              description: 'Paying views: currentReach minus initialReach.'
            currentReach:
              type: integer
            initialReach:
              type: integer
            likes:
              type: integer
            comments:
              type: integer
        budget:
          type: object
          properties:
            label:
              type: string
            totalPool:
              type:
              - string
              - 'null'
              description: Campaign budget. Decimal string.
            remainingPool:
              type:
              - string
              - 'null'
              description: Budget not yet committed. Decimal string.
            usedBudget:
              type:
              - string
              - 'null'
              description: Already paid out. Decimal string.
            tokenType:
              type: string
            tokenSymbol:
              type: string
        tasksTab:
          type: object
          properties:
            requirements:
              type: object
              properties:
                guidelines:
                  type:
                  - string
                  - 'null'
                hashtags:
                  type: array
                  items:
                    type: string
                mentions:
                  type: array
                  items:
                    type: string
                urls:
                  type: array
                  items:
                    type: string
            tasks:
              type: array
              items:
                type: object
                properties:
                  taskId:
                    type: string
                    format: uuid
                  platformId:
                    type: string
                    format: uuid
                  platformName:
                    type: string
                  platformSlug:
                    type: string
                  type:
                    type: string
                  submissionRequirements:
                    $ref: '#/components/schemas/SubmissionRequirements'
                  submissionCounts:
                    type: object
                    properties:
                      total:
                        type: integer
                      pending:
                        type: integer
                      approved:
                        type: integer
                      rejected:
                        type: integer
                      paid:
                        type: integer
                      nonRejected:
                        type: integer
        settingsTab:
          type: object
          properties:
            userEligibilityCriteria:
              type: object
              properties: {}
              additionalProperties: true
            platformPayouts:
              type: array
              items:
                type: object
                properties:
                  taskId:
                    type: string
                    format: uuid
                  platformId:
                    type: string
                    format: uuid
                  platformName:
                    type: string
                  platformSlug:
                    type: string
                  claimType:
                    type: string
                    enum:
                    - FCFS
                    - OFFERS
                  payoutLogic:
                    type: string
                    enum:
                    - FORMULA
                    - FIXED
                  cpm:
                    type:
                    - number
                    - 'null'
                    description: Payout per 1000 paying views.
                  fixedPayout:
                    type:
                    - number
                    - 'null'
                  minViews:
                    type:
                    - integer
                    - 'null'
                  maxPayoutPerClip:
                    type:
                    - number
                    - 'null'
                  bonusRanges:
                    type: array
                    items:
                      $ref: '#/components/schemas/BonusRange'
                  tokenType:
                    type: string
                  tokenSymbol:
                    type: string
    Metadata:
      type: object
      properties:
        page:
          type: integer
        limit:
          type: integer
        totalItems:
          type: integer
        totalPages:
          type: integer
      description: Standard pagination envelope.
    BountySubmissionTask:
      type: object
      properties:
        taskId:
          type: string
          format: uuid
        submissionId:
          type: string
          format: uuid
        taskType:
          type: string
        taskUrl:
          type:
          - string
          - 'null'
          description: 'What the creator was asked to act on. On a follow task this is the profile to follow. It is not what the creator turned in: that is `submissionContent.url`.'
        submissionStatus:
          type: string
          enum:
          - PENDING
          - APPROVED
          - REJECTED
          - FAILED
          - PAID
          - MILESTONE_BONUS_PAID
          - DEMOGRAPHICS_DUE
          - DEMOGRAPHICS_REVIEW
        submissionReason:
          type:
          - string
          - 'null'
          description: Reviewer note, when rejected.
        aiReview:
          type: object
          properties: {}
          description: AI moderation result, when approvalMode is AI.
          additionalProperties: true
        claimedAt:
          type:
          - string
          - 'null'
          format: date-time
        submittedAt:
          type:
          - string
          - 'null'
          format: date-time
        submissionContent:
          type: object
          properties:
            url:
              type:
              - string
              - 'null'
            externalId:
              type:
              - string
              - 'null'
            text:
              type:
              - string
              - 'null'
            viewCount:
              type: integer
            replyCount:
              type: integer
            favoriteCount:
              type: integer
          description: What the creator turned in for the task. `url` is the link they submitted.
    BountySubmission:
      type: object
      properties:
        submissionId:
          type: string
          format: uuid
        userId:
          type:
          - string
          - 'null'
          description: Airaa user id of the creator.
          format: uuid
        profileId:
          type:
          - string
          - 'null'
          format: uuid
        userUsername:
          type:
          - string
          - 'null'
          description: Airaa username.
        username:
          type:
          - string
          - 'null'
          description: Handle on the posting platform, not the Airaa username. The Airaa username is `userUsername`.
        name:
          type:
          - string
          - 'null'
          description: Display name on the posting platform.
        profileImageUrl:
          type:
          - string
          - 'null'
        followersCount:
          type: integer
        viewCount:
          type:
          - integer
          - 'null'
        initialViewCount:
          type:
          - integer
          - 'null'
        currentViewCount:
          type:
          - integer
          - 'null'
        deltaViewCount:
          type:
          - integer
          - 'null'
        offerInfo:
          oneOf:
          - type: object
            properties:
              offerAmount:
                type:
                - string
                - 'null'
              counterOfferAmount:
                type:
                - string
                - 'null'
              offerStatus:
                type: string
          - type: 'null'
          description: Live state of the negotiation on an OFFERS campaign. `counterOfferAmount` is set once the creator counters.
        tokenAmount:
          type:
          - string
          - 'null'
          description: Already paid. Decimal string.
        auraPointsAmount:
          type:
          - string
          - 'null'
          description: Aura points awarded. Decimal string.
        estimatedPayout:
          type:
          - string
          - 'null'
          description: What this submission would earn at its current numbers. Decimal string.
        tasks:
          type: array
          items:
            $ref: '#/components/schemas/BountySubmissionTask'
    SubmissionEngagement:
      type: object
      properties:
        views:
          type: integer
          description: Alias of `deltaViews`, the views that pay.
        initialViews:
          type: integer
          description: View count when the clip was submitted.
        currentViews:
          type: integer
          description: View count now.
        deltaViews:
          type: integer
          description: currentViews minus initialViews. This is what pays.
        likes:
          type: integer
        comments:
          type: integer
    SubmissionAction:
      type: object
      properties:
        actionType:
          type: string
          enum:
          - PENDING
          - APPROVED
          - FAILED
          - PAID
          - MILESTONE_BONUS_PAID
          - DEMOGRAPHICS_DUE
          - DEMOGRAPHICS_REVIEW
          - REJECTED
        amount:
          type:
          - string
          - 'null'
          description: Amount moved by this action, when it was a payment. Decimal string.
        viewsSnapshot:
          type:
          - integer
          - 'null'
          description: View count at the moment of the action.
        deltaViews:
          type:
          - integer
          - 'null'
        reason:
          type:
          - string
          - 'null'
        createdAt:
          type: string
          format: date-time
      description: One row of the payout ledger, newest first.
    VideoSubmission:
      type: object
      properties:
        submissionId:
          type: string
          format: uuid
        taskId:
          type: string
          format: uuid
        platformId:
          type: string
          format: uuid
        platformName:
          type: string
        platformSlug:
          type: string
        creatorUserId:
          type: string
          format: uuid
        creatorUsername:
          type:
          - string
          - 'null'
        creatorPhotoUrl:
          type:
          - string
          - 'null'
        followersCount:
          type: integer
        status:
          type: string
          enum:
          - PENDING
          - APPROVED
          - REJECTED
          - FAILED
          - PAID
          - MILESTONE_BONUS_PAID
          - DEMOGRAPHICS_DUE
          - DEMOGRAPHICS_REVIEW
        rejectionReason:
          type:
          - string
          - 'null'
        submittedAt:
          type: string
          format: date-time
        expiresAt:
          type:
          - string
          - 'null'
          description: Claim expiry. A far-future date means no expiry.
          format: date-time
        contentId:
          type: string
          format: uuid
          description: Id of the row in the content table. A submission does not always have one.
        contentUrl:
          type:
          - string
          - 'null'
          description: The public post.
        contentTitle:
          type:
          - string
          - 'null'
        thumbnailUrl:
          type:
          - string
          - 'null'
        videoUrl:
          type:
          - string
          - 'null'
          description: Archived copy of the clip on the Airaa CDN. Treat as private to the brand.
        commentCount:
          type: integer
        engagement:
          $ref: '#/components/schemas/SubmissionEngagement'
        estimatedPayout:
          type:
          - string
          - 'null'
          description: Owed for views accrued but not yet paid. Decimal string.
        tokenReward:
          type:
          - string
          - 'null'
          description: Configured reward on the task row, not the amount paid. Decimal string.
        auraPointsReward:
          type:
          - string
          - 'null'
          description: Aura points awarded. Decimal string.
        basePaidAmount:
          type:
          - string
          - 'null'
          description: Paid from the per-view rate. Decimal string.
        bonusPaidAmount:
          type:
          - string
          - 'null'
          description: Paid from view milestones. Decimal string.
        totalPaidAmount:
          type:
          - string
          - 'null'
          description: basePaidAmount + bonusPaidAmount. Already sent. Decimal string.
        cumulativePaidAmount:
          type:
          - string
          - 'null'
          description: Same as totalPaidAmount. Decimal string.
        lastPaidAt:
          type:
          - string
          - 'null'
          format: date-time
        accruedUnpaid:
          type:
          - string
          - 'null'
          description: Owed but NOT yet sent. Decimal string.
        accruedBaseAmount:
          type:
          - string
          - 'null'
          description: Unpaid portion from the per-view rate. Decimal string.
        accruedBonusAmount:
          type:
          - string
          - 'null'
          description: Unpaid portion from milestones. Decimal string.
        maxPayoutPerClip:
          type:
          - number
          - 'null'
        submissionActions:
          type: array
          items:
            $ref: '#/components/schemas/SubmissionAction'
        demographicsVideoUrl:
          type:
          - string
          - 'null'
          description: Creator-recorded proof of their audience demographics. Private to the brand.
        demographicsReviewResult:
          type:
          - string
          - 'null'
          enum:
          - APPROVED
          - REJECTED
          - null
    MemberPlatform:
      type: object
      properties:
        slug:
          type: string
        handle:
          type:
          - string
          - 'null'
        followersCount:
          type: integer
    Member:
      type: object
      properties:
        userId:
          type: string
          format: uuid
        username:
          type:
          - string
          - 'null'
          description: Airaa username.
        name:
          type:
          - string
          - 'null'
        photoUrl:
          type:
          - string
          - 'null'
        status:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - PENDING
          - SUSPENDED
        role:
          type: string
          enum:
          - MEMBER
          - MODERATOR
          - ADMIN
        niche:
          oneOf:
          - type: array
            items:
              type: string
          - type: 'null'
        locationCountry:
          type:
          - string
          - 'null'
        platforms:
          type: array
          items:
            $ref: '#/components/schemas/MemberPlatform'
        totalFollowers:
          type: integer
        communityCampaignsParticipated:
          type: integer
        totalCommunityImpressions:
          type: integer
          description: Views this member earned in the community you asked about, not their total across Airaa.
        tags:
          type: array
          items:
            type: string
          description: Assigned by hand by the community's operators. There is no fixed list of values.
    LeaderboardRow:
      type: object
      properties:
        rank:
          type: integer
        username:
          type:
          - string
          - 'null'
          description: Airaa username.
        name:
          type:
          - string
          - 'null'
        photoUrl:
          type:
          - string
          - 'null'
        socialConnections:
          type: array
          items:
            $ref: '#/components/schemas/MemberPlatform'
        totalCampaigns:
          type: integer
        totalViews:
          type: integer
        totalUsdc:
          type:
          - string
          - 'null'
          description: USDC earned in the range. Decimal string.
        totalCommunityToken:
          type:
          - string
          - 'null'
          description: Community points earned in the range. Decimal string.
      description: Every row carries all four totals regardless of sortBy; sortBy only orders them.
    ChatThread:
      type: object
      properties:
        creatorUserId:
          type: string
          description: Pass this to get_chat_messages to read the thread.
          format: uuid
        projectId:
          type: string
          format: uuid
        username:
          type:
          - string
          - 'null'
          description: Airaa username of the creator.
        userDisplayName:
          type:
          - string
          - 'null'
        userPhotoUrl:
          type:
          - string
          - 'null'
        lastMessagePreview:
          type: string
        lastMessageType:
          type: string
          enum:
          - text
          - image
          - video
          - system
          - draft_submission
        lastMessageAt:
          type: string
          format: date-time
        unreadCount:
          type: integer
          description: Messages the brand has not read.
        pendingReviewCount:
          type: integer
          description: Submissions from this creator awaiting review. Not unread messages.
    ChatReply:
      type: object
      properties:
        id:
          type: string
          format: uuid
        senderType:
          type: string
          enum:
          - creator
          - brand
          - airaa
        senderDisplayName:
          type:
          - string
          - 'null'
        senderUsername:
          type:
          - string
          - 'null'
        messageType:
          type: string
          enum:
          - text
          - image
          - video
          - system
          - draft_submission
        content:
          type: string
        media:
          type: object
          properties: {}
          additionalProperties: true
      description: The quoted message, when this one is a reply.
    ChatMessage:
      type: object
      properties:
        id:
          type: string
          format: uuid
        creatorUserId:
          type: string
          format: uuid
        projectCampaignId:
          type:
          - string
          - 'null'
          description: Set when the message is campaign-scoped.
          format: uuid
        campaignTitle:
          type:
          - string
          - 'null'
        senderType:
          type: string
          description: '`airaa` marks an automated system message.'
          enum:
          - creator
          - brand
          - airaa
        senderDisplayName:
          type:
          - string
          - 'null'
        senderUsername:
          type:
          - string
          - 'null'
        senderPhotoUrl:
          type:
          - string
          - 'null'
        messageType:
          type: string
          enum:
          - text
          - image
          - video
          - system
          - draft_submission
        content:
          type: string
        media:
          type:
          - object
          - 'null'
          properties: {}
          description: Attachment. Private to the brand.
          additionalProperties: true
        videoUrl:
          type:
          - string
          - 'null'
          description: Archived clip on the Airaa CDN, when a submission is linked. Private to the brand.
        replyToMessageId:
          type:
          - string
          - 'null'
          format: uuid
        replyToMessage:
          oneOf:
          - $ref: '#/components/schemas/ChatReply'
          - type: 'null'
        isReadByBrand:
          type: boolean
        isReadByCreator:
          type: boolean
        createdAt:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        error:
          type: string
          description: Why the call failed, in a sentence. The HTTP status carries the category; this is the only field in the body.
