> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minenet.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# List available software



## OpenAPI

````yaml api-reference/openapi.yaml get /servers/software
openapi: 3.1.0
info:
  title: Minenet Client API
  version: 1.0.0
  description: >
    Team-scoped API for deployments, servers, snapshots, files, and mod platform
    metadata.


    Authentication:

    - Bearer user token (`mnp_*`)

    - Bearer agent token (`mna_*`)


    Global rate limit: 100 requests/minute per token.
servers:
  - url: https://your-domain.com/api/client/v1
security:
  - bearerAuth: []
tags:
  - name: Deployments
  - name: Servers
  - name: Snapshots
  - name: Files
  - name: Modrinth
  - name: CurseForge
paths:
  /servers/software:
    get:
      tags:
        - Servers
      summary: List available software
      operationId: listServerSoftware
      responses:
        '200':
          description: Software catalog
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  software:
                    type: array
                    items:
                      $ref: '#/components/schemas/SoftwareProfile'
              examples:
                default:
                  summary: Available software and user-facing environment variables
                  value:
                    count: 5
                    software:
                      - id: 15
                        name: Paper
                        type: paper
                        description: Paper Minecraft server
                        docker_images:
                          - value: ghcr.io/parkervcp/yolks:java_21
                            label: Java 21
                          - value: ghcr.io/parkervcp/yolks:java_17
                            label: Java 17
                          - value: ghcr.io/parkervcp/yolks:java_16
                            label: Java 16
                          - value: ghcr.io/parkervcp/yolks:java_8
                            label: Java 8
                        environment_variables:
                          - key: MINECRAFT_VERSION
                            title: Minecraft version
                            description: >-
                              The desired Minecraft version to install (e.g.
                              1.20.1)
                            default: latest
                            optional: false
                          - key: BUILD_NUMBER
                            title: Paper build number (optional)
                            description: >-
                              The desired Paper build number to install (e.g.
                              100)
                            default: latest
                            optional: true
                      - id: 16
                        name: Forge
                        type: forge
                        description: Forge Minecraft server
                        docker_images:
                          - value: ghcr.io/parkervcp/yolks:java_21
                            label: Java 21
                          - value: ghcr.io/parkervcp/yolks:java_17
                            label: Java 17
                          - value: ghcr.io/parkervcp/yolks:java_16
                            label: Java 16
                          - value: ghcr.io/parkervcp/yolks:java_8
                            label: Java 8
                        environment_variables:
                          - key: MC_VERSION
                            title: Minecraft version
                            description: >-
                              The desired Minecraft version to install (e.g.
                              1.20.1)
                            default: latest
                            optional: false
                          - key: BUILD_TYPE
                            title: Build type
                            description: The desired Forge build type to install
                            default: recommended
                            optional: false
                      - id: 28
                        name: NeoForge
                        type: neoforge
                        description: NeoForge Minecraft server
                        docker_images:
                          - value: ghcr.io/parkervcp/yolks:java_21
                            label: Java 21
                          - value: ghcr.io/parkervcp/yolks:java_17
                            label: Java 17
                          - value: ghcr.io/parkervcp/yolks:java_16
                            label: Java 16
                          - value: ghcr.io/parkervcp/yolks:java_8
                            label: Java 8
                        environment_variables:
                          - key: MC_VERSION
                            title: Minecraft version
                            description: >-
                              The desired Minecraft version to install (e.g.
                              1.20.1)
                            default: latest
                            optional: false
                          - key: NEOFORGE_VERSION
                            title: NeoForge Version
                            description: The full exact NeoForge version
                            default: ''
                            optional: false
                      - id: 24
                        name: Vanilla
                        type: vanilla
                        description: Vanilla Minecraft server
                        docker_images:
                          - value: ghcr.io/parkervcp/yolks:java_21
                            label: Java 21
                          - value: ghcr.io/parkervcp/yolks:java_17
                            label: Java 17
                          - value: ghcr.io/parkervcp/yolks:java_16
                            label: Java 16
                          - value: ghcr.io/parkervcp/yolks:java_8
                            label: Java 8
                        environment_variables:
                          - key: VANILLA_VERSION
                            title: Minecraft version
                            description: >-
                              The desired Minecraft version to install (e.g.
                              1.20.1)
                            default: latest
                            optional: false
                      - id: 39
                        name: Fabric
                        type: fabric
                        description: Fabric Minecraft server
                        docker_images:
                          - value: ghcr.io/parkervcp/yolks:java_21
                            label: Java 21
                          - value: ghcr.io/parkervcp/yolks:java_17
                            label: Java 17
                          - value: ghcr.io/parkervcp/yolks:java_16
                            label: Java 16
                          - value: ghcr.io/parkervcp/yolks:java_8
                            label: Java 8
                        environment_variables:
                          - key: MC_VERSION
                            title: Minecraft version
                            description: >-
                              The desired Minecraft version to install (e.g.
                              1.20.1)
                            default: latest
                            optional: false
                          - key: FABRIC_VERSION
                            title: Fabric version
                            description: The desired Fabric version to install
                            default: latest
                            optional: false
                          - key: LOADER_VERSION
                            title: Loader version
                            description: The desired Fabric Loader version to install
                            default: latest
                            optional: false
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    SoftwareProfile:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        type:
          type: string
        description:
          type: string
        docker_images:
          type: array
          items:
            type: object
            properties:
              value:
                type: string
              label:
                type: string
        environment_variables:
          type: array
          items:
            type: object
            properties:
              key:
                type: string
              title:
                type: string
              description:
                type: string
              default:
                oneOf:
                  - type: string
                  - type: number
                  - type: boolean
                  - type: 'null'
              optional:
                type: boolean
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
      required:
        - error
  responses:
    Unauthorized:
      description: Authentication failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: token

````