Futureverse Campaigns API

openapi: 3.2.0
info:
  title: RootRewards Quest Campaigns API
  version: '2025-08-16'
  summary: Retrieve quest and campaign information and allocate RootRewards points to FuturePass addresses.
  description: The RootRewards Quest API lets an approved external service read quest and campaign detail and allocate points from a quest budget to a FuturePass (Pass) address on The Root Network.
  contact:
    name: The Root Network documentation
    url: https://docs.therootnetwork.com/rootrewards/overview
  x-provenance:
    generated: '2026-08-16'
    method: generated
    generated-by: API Evangelist enrichment pipeline (local-v1)
    source: https://docs.therootnetwork.com/rootrewards/api-reference
    source-status: 200
    first-party: false
servers:
- url: '{baseUrl}'
  description: Base URL is issued privately to approved Quest applications and is not published. A separate staging base URL is issued for API-only testing.
  variables:
    baseUrl:
      default: https://REPLACE-WITH-BASE-URL-ISSUED-ON-APPROVAL
      description: The base URL Futureverse issues when a Quest application is approved.
security:
- questApiKey: []
tags:
- name: Campaigns
  description: Public campaign detail. Campaigns group quests but hold no balances.
paths:
  /campaigns/{id}:
    get:
      operationId: getCampaign
      tags:
      - Campaigns
      summary: Get campaign details
      description: Retrieves public campaign details and the quests it groups. No API key required.
      security: []
      parameters:
      - name: id
        in: path
        required: true
        description: Numeric ID of the campaign.
        schema:
          type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaign'
        '400':
          description: Campaign is disabled or bad request
        '404':
          description: Campaign not found
components:
  schemas:
    Campaign:
      type: object
      properties:
        id:
          type: integer
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        name:
          type: string
        description:
          type: string
        start:
          type: string
          format: date-time
        end:
          type: string
          format: date-time
        is_active:
          type: boolean
        external_app_id:
          type:
          - string
          - 'null'
        quests:
          type: array
          items:
            $ref: '#/components/schemas/CampaignQuest'
    CampaignQuest:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        description:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        start:
          type: string
          format: date-time
        end:
          type: string
          format: date-time
        is_public:
          type: boolean
        total_points:
          type: integer
        expected_points_per_completion:
          type: integer
        owner_id:
          type: string
        campaign_id:
          type: integer
  securitySchemes:
    questApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Quest API key. Must start with the prefix `sk_` and be associated with the quest owner account. Issued on Quest application approval; never expose it in client-side code.