Mighty Networks

Mighty Networks Assets API

Manage assets for your network

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.mightynetworks.com/members
📖
APIReference
https://docs.mightynetworks.com/api-reference/members/return-members-of-the-given-network
📖
Documentation
https://docs.mightynetworks.com/spaces
📖
APIReference
https://docs.mightynetworks.com/api-reference/spaces/returns-a-list-of-spaces-for-the-current-network
📖
Documentation
https://docs.mightynetworks.com/posts
📖
APIReference
https://docs.mightynetworks.com/api-reference/posts/returns-a-list-of-posts-for-the-current-network
📖
APIReference
https://docs.mightynetworks.com/api-reference/comments/returns-a-list-of-comments-for-a-specific-post
📖
APIReference
https://docs.mightynetworks.com/api-reference/events/returns-a-paginated-list-of-events-in-the-network
📖
APIReference
https://docs.mightynetworks.com/api-reference/courseworks/returns-a-list-of-coursework-items-for-the-given-space-course
📖
APIReference
https://docs.mightynetworks.com/api-reference/plans/return-all-plans-in-the-network
📖
APIReference
https://docs.mightynetworks.com/api-reference/invites/returns-a-list-of-invitations-for-the-current-network
📖
APIReference
https://docs.mightynetworks.com/api-reference/badges/return-all-badges-for-the-network
📖
APIReference
https://docs.mightynetworks.com/api-reference/customfields/return-custom-fields-of-the-given-network
📖
APIReference
https://docs.mightynetworks.com/api-reference/polls/returns-a-paginated-list-of-polls-and-questions-in-the-network
📖
Documentation
https://docs.mightynetworks.com/networks
📖
APIReference
https://docs.mightynetworks.com/api-reference/networks/returns-details-of-the-network--must-match-the-network-owning-the-requesting-api-key
📖
Documentation
https://docs.mightynetworks.com/api-reference/webhooks/memberjoined

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mighty-networks/refs/heads/main/openapi/mighty-networks-assets-api-openapi.yml

OpenAPI Specification

mighty-networks-assets-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  version: 1.0.0
  title: The Mighty Networks Admin AbuseReports Assets API
  description: An API for managing your Mighty Networks network
servers:
- url: https://api.mn.co
  description: Production
security:
- bearerAuth: []
tags:
- name: Assets
  description: Manage assets for your network
paths:
  /admin/v1/networks/{network_id}/assets:
    post:
      summary: Upload a new asset (image or file)
      operationId: create_assets
      tags:
      - Assets
      parameters:
      - $ref: '#/components/parameters/networkId'
      requestBody:
        description: Submit as multipart/form-data
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                asset_style:
                  type: string
                  description: The style/purpose of the asset
                  enum:
                  - avatar
                  - avatar_suggestion
                  - header_suggestion
                  - avatar_dark_mode
                  - thumbnail
                  - square_thumbnail
                  - bundle_description
                  - landing_page_background
                  - landing_page_video
                  - customer_site_logo
                  - space_avatar
                  - space_description
                  - brand_banner_on_color
                  - brand_banner_on_white
                  - brand_banner_dark_mode
                  - background_image_banner
                  - background_image_banner_fixed_ratio
                  - post_description
                  - landing_page_description
                  - cover
                  - post
                  - comment
                  - file
                  - header
                  - cinema_header
                  - profile_prompt_answer
                  - new_member_pitch
                  - embedded_link
                  - user_cover
                  - video
                  - course_video
                  - live_mp4_recording
                  - live_mp4_recording_backup
                  - comment_video
                  - ai_interaction
                  - automation_action_image
                  - landing_page_content
                  - seo_image
                  - voice_note
                asset_file:
                  type: string
                  format: binary
                  description: The file to upload
                source_url:
                  type: string
                  format: url
                  description: URL to download asset from (alternative to asset_file)
                input_type:
                  type: string
                  description: Deprecated - do not use
                  deprecated: true
                original_aspect_ratio:
                  type: string
                  description: Original aspect ratio of the asset
                metadata:
                  type: object
                  description: Additional metadata for the asset (e.g., is_main_image, is_video_image)
      responses:
        '201':
          description: The created asset object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetResponse'
        '400':
          description: Invalid request - missing required parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing, invalid, expired, or revoked access token, or network mismatch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    networkId:
      name: network_id
      in: path
      description: The Network's unique integer ID, or subdomain
      required: true
      schema:
        oneOf:
        - type: integer
          description: Unique numeric network ID
          format: uint64
        - type: string
          description: Network subdomain
          format: /^[a-z][a-z0-9-]+$/
  schemas:
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: An error message explaining the problem encountered
    AssetResponse:
      description: File or media asset attached to content
      type: object
      required:
      - id
      - type
      properties:
        id:
          type: integer
          format: uint64
          description: The record's integer ID
          example: '1234'
        url:
          type: string
          format: url
          description: URL to access the asset
        type:
          type: string
          description: The type of asset (Asset, StaticAsset, etc.)
        name:
          type: string
          description: Original filename of the asset
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer