Mighty Networks

Mighty Networks Posts API

Posts also include Articles.

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-posts-api-openapi.yml

OpenAPI Specification

mighty-networks-posts-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  version: 1.0.0
  title: The Mighty Networks Admin AbuseReports Posts API
  description: An API for managing your Mighty Networks network
servers:
- url: https://api.mn.co
  description: Production
security:
- bearerAuth: []
tags:
- name: Posts
  description: Posts also include Articles.
paths:
  /admin/v1/networks/{network_id}/posts:
    get:
      summary: Returns a list of posts for the current network
      operationId: list_posts
      tags:
      - Posts
      parameters:
      - name: space_id
        in: query
        required: false
        description: Filter posts by space ID
        schema:
          type: integer
          format: uint64
      - name: page
        in: query
        required: false
        description: Page number for pagination
        schema:
          type: integer
          format: uint64
      - name: per_page
        in: query
        required: false
        description: Items per page (max 100)
        schema:
          type: integer
          format: uint64
      - $ref: '#/components/parameters/networkId'
      responses:
        '200':
          description: A paginated set of posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponsePaged'
    post:
      summary: Create a new post, and optionally notify the network
      operationId: create_posts
      tags:
      - Posts
      parameters:
      - name: notify
        in: query
        required: false
        description: Whether or not to notify the network
        schema:
          type: boolean
      - $ref: '#/components/parameters/networkId'
      requestBody:
        description: Submit results as JSON
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostRequest'
      responses:
        '201':
          description: Returns the newly created post on success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponse'
        '404':
          description: Space not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Invalid post data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /admin/v1/networks/{network_id}/posts/{id}/:
    get:
      summary: Query details of a specific post by its ID
      operationId: show_post
      tags:
      - Posts
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the post to fetch
        schema:
          type: integer
          format: uint64
      - $ref: '#/components/parameters/networkId'
      responses:
        '200':
          description: Details about the requested post
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponse'
        '404':
          description: Post not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    patch:
      summary: Update an existing post or article
      operationId: update_posts
      tags:
      - Posts
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the post to update
        schema:
          type: integer
          format: uint64
      - name: notify
        in: query
        required: false
        description: Whether or not to notify the network
        schema:
          type: boolean
      - $ref: '#/components/parameters/networkId'
      requestBody:
        description: Submit results as JSON
        required: true
        content:
          application/json:
            schema:
              description: Request to update a post or article
              type: object
              properties:
                title:
                  type: string
                  description: The title of the post
                description:
                  type: string
                  description: The description/body content of the post
      responses:
        '200':
          description: Returns the updated post on success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponse'
        '404':
          description: Post not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Invalid post data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    put:
      summary: Update an existing post or article
      operationId: replace_posts
      tags:
      - Posts
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the post to update
        schema:
          type: integer
          format: uint64
      - name: notify
        in: query
        required: false
        description: Whether or not to notify the network
        schema:
          type: boolean
      - $ref: '#/components/parameters/networkId'
      requestBody:
        description: Submit results as JSON
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostUpdateRequest'
      responses:
        '200':
          description: Returns the updated post on success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponse'
        '404':
          description: Post not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Invalid post data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    delete:
      summary: Delete a post or article
      operationId: delete_posts
      tags:
      - Posts
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the post to delete
        schema:
          type: integer
          format: uint64
      - $ref: '#/components/parameters/networkId'
      responses:
        '204':
          description: Post successfully deleted
        '404':
          description: Post not found
          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
    PostResponse:
      description: Posts are created by users within spaces
      type: object
      required:
      - comments_enabled
      - content_type
      - created_at
      - creator_id
      - description
      - id
      - images
      - last_activity_at
      - permalink
      - post_type
      - published_at
      - space_id
      - status
      - summary
      - title
      - updated_at
      properties:
        id:
          type: integer
          format: uint64
          description: The record's integer ID
          example: '1234'
        created_at:
          type: string
          format: date-time
          description: The date and time the record was created
          example: '2026-07-05T21:11:41+00:00'
        updated_at:
          type: string
          format: date-time
          description: The date and time the record was last modified
          example: '2026-07-05T21:11:41+00:00'
        creator_id:
          type: integer
          format: uint64
          description: The ID of the user that created the post
        space_id:
          type: integer
          format: uint64
          description: The ID of the space where the post was created
        summary:
          type: string
          description: A short summary of the post's contents
        description:
          type: string
          description: The posts description
        post_type:
          type: string
          description: The type of post
        images:
          type: array
          description: An array of image URLs associated with the post
          items:
            type: string
        title:
          type: string
          description: The title of the post
        status:
          type: string
          description: The post's current status
        published_at:
          type: string
          format: date-time
          description: The date the post was published
          example: '2026-07-05T21:11:42+00:00'
        last_activity_at:
          type: string
          format: date-time
          description: The time the of last activity on the post
          example: '2026-07-05T21:11:42+00:00'
        content_type:
          type: string
          description: The type of post content attached to the post
        comments_enabled:
          type: boolean
          description: Whether or not comments are enabled on this post
        permalink:
          type: string
          format: url
          description: The post's unique address within the network
    PostRequest:
      description: Posts are created by users within spaces
      type: object
      required:
      - space_id
      - title
      properties:
        space_id:
          type: integer
          format: uint64
          description: The ID of the space to post in
        title:
          type: string
          description: The title of the post
        description:
          type: string
          description: The description/body content of the post
        post_type:
          type: string
          description: The type of post to create (e.g., 'article')
    PostUpdateRequest:
      description: Request to update a post or article
      type: object
      required: []
      properties:
        title:
          type: string
          description: The title of the post
        description:
          type: string
          description: The description/body content of the post
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer