Braiins

Braiins Upgrade API

The Upgrade API from Braiins — 3 operation(s) for upgrade.

GitHub OpenAPI

Operations 4

GET /api/v1/upgrade/auto-upgrade Get auto-upgrade settings #
PATCH /api/v1/upgrade/auto-upgrade Set auto-upgrade settings #
POST /api/v1/upgrade/restore-stock Restore stock #
POST /api/v1/upgrade/system-upgrade System upgrade #

Documentation

📖
Documentation
https://academy.braiins.com/braiins-os/papi-about.md
📖
APIReference
https://developer.braiins-os.com/latest/openapi.html
📖
Documentation
https://academy.braiins.com/braiins-hashpower/api.md
📖
APIReference
https://hashpower.braiins.com/api
📖
GettingStarted
https://academy.braiins.com/braiins-hashpower/quick-start.md

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/braiins-academy/refs/heads/main/openapi/braiins-academy-upgrade-api-openapi.yml

Other Resources

🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/braiins-academy/refs/heads/main/grpc/braiins-academy-bos-miner.proto
🔗
SourceCode
https://github.com/braiins/bos-plus-api
🔗
Examples
https://github.com/braiins/bos-plus-api-demos
🔗
ChangeLog
https://academy.braiins.com/braiins-os/papi-changelog.md
🔗
Pricing
https://academy.braiins.com/braiins-hashpower/fees.md
🔗
TermsOfService
https://hashpower.braiins.com/terms-and-conditions.html

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/braiins-academy-upgrade-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

braiins-academy-upgrade-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Braiins OS Public REST Upgrade API
  description: ''
  contact:
    name: Braiins
    url: https://help.braiins.com
    email: help@braiins.com
  license:
    name: ''
  version: 1.7.0
servers:
- url: http://miner/
tags:
- name: Upgrade
paths:
  /api/v1/upgrade/auto-upgrade:
    get:
      tags:
      - Upgrade
      summary: Get auto-upgrade settings
      description: Get the current auto-upgrade configuration.
      operationId: getAutoUpgradeStatus
      responses:
        '200':
          description: Successful response with auto-upgrade settings
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAutoUpgradeStatusResponse'
              example:
                enabled: true
                last_execution:
                  nanos: 0
                  seconds: 1744085400
                next_execution:
                  nanos: 0
                  seconds: 1744171800
                schedule:
                  schedule_type:
                    daily:
                      time:
                        hours: 3
                        minutes: 30
                        seconds: null
    patch:
      tags:
      - Upgrade
      summary: Set auto-upgrade settings
      description: Configure auto-upgrade settings.
      operationId: updateAutoUpgradeConfig
      requestBody:
        description: Auto-upgrade configuration
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAutoUpgradeConfigRequest'
            example:
              enabled: true
              schedule:
                schedule_type:
                  daily:
                    time:
                      hours: 3
                      minutes: 30
                      seconds: 21
        required: true
      responses:
        '200':
          description: Auto-upgrade settings updated successfully
          content:
            application/json:
              example:
                enabled: true
                next_execution:
                  nanos: 0
                  seconds: 1744171800
  /api/v1/upgrade/restore-stock:
    post:
      tags:
      - Upgrade
      summary: Restore stock
      description: Uninstalls BraiinsOS and restores the miner to its original stock firmware. After initial checks pass, the response is returned and the restoration continues in the background. The device will become unreachable as the process proceeds. Not supported on all platforms (e.g. BMM) or SD card installations.
      operationId: restoreStock
      responses:
        '204':
          description: Successful response.
        '409':
          description: Another system task is already in progress.
        '500':
          description: Internal server error.
        '501':
          description: Uninstall is not supported on this platform.
  /api/v1/upgrade/system-upgrade:
    post:
      tags:
      - Upgrade
      summary: System upgrade
      description: Performs system upgrade.
      operationId: systemUpgrade
      requestBody:
        description: Stream of metadata and data. First message of the stream has to be `metadata`. Additional messages of the stream have to be `data`.
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/SystemUpgradeRequestRest'
            example:
              data:
              - - 0
                - 0
                - 0
                - 0
              - - 0
                - 0
                - 0
                - 0
              - - 0
                - 0
                - 0
                - 0
              - - 0
                - 0
                - 0
                - 0
              metadata:
                disable_cleanup: false
                discard_settings: false
                hash: fcdb4b423f4e5283afa249d762ef6aef150e91fccd810d43e5e719d14512dec7
                size: 16
        required: true
      responses:
        '204':
          description: Successful response.
        '409':
          description: Another system task is already in progress.
        '500':
          description: Internal server error.
components:
  schemas:
    AutoUpgradeSchedule:
      type: object
      properties:
        schedule_type:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/ScheduleType'
    WeeklySchedule:
      type: object
      properties:
        day_of_week:
          type:
          - integer
          - 'null'
          format: int32
        time:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/UpgradeTime'
    Timestamp:
      type: object
      description: 'Custom version of google.protobuf.Timestamp

        It is used only during compilation to replace google.protobuf.Timestamp to

        enable traits for de/serialization and for generating documentation'
      required:
      - seconds
      - nanos
      properties:
        nanos:
          type: integer
          format: int32
        seconds:
          type: integer
          format: int64
    UpdateAutoUpgradeConfigRequest:
      type: object
      required:
      - enabled
      properties:
        enabled:
          type: boolean
        schedule:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/AutoUpgradeSchedule'
    SystemUpgradeRequestRest:
      type: object
      required:
      - metadata
      - data
      properties:
        data:
          type: array
          items:
            type: array
            items:
              type: integer
              format: int32
              minimum: 0
        metadata:
          $ref: '#/components/schemas/SystemUpgradeMetadata'
    SystemUpgradeMetadata:
      type: object
      required:
      - size
      - hash
      - discard_settings
      - disable_cleanup
      properties:
        disable_cleanup:
          type: boolean
          description: Flag if should disable cleanup of directory, in which uploaded firmware is stored (default is false and do cleanup)
        discard_settings:
          type: boolean
          description: Flag if should discard settings (default is false and keep settings)
        hash:
          type: string
          description: Firmware hash (SHA256 hex encoded)
        size:
          type: integer
          format: int64
          description: Firmware size (bytes)
          minimum: 0
    MonthlySchedule:
      type: object
      properties:
        day_of_month:
          type:
          - integer
          - 'null'
          format: int32
          description: Artificially limited to 1-28 to cover all months
          minimum: 0
        time:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/UpgradeTime'
    UpgradeTime:
      type: object
      required:
      - hours
      - minutes
      properties:
        hours:
          type: integer
          format: int32
          description: Hours of day in 24 hour format. Must be from 0 to 23.
          minimum: 0
        minutes:
          type: integer
          format: int32
          description: Minutes of hour of day. Must be from 0 to 59.
          minimum: 0
        seconds:
          type:
          - integer
          - 'null'
          format: int32
          description: Seconds of minutes of the time. Can be from 0 to 59.
          minimum: 0
    ScheduleType:
      oneOf:
      - type: object
        required:
        - daily
        properties:
          daily:
            $ref: '#/components/schemas/DailySchedule'
      - type: object
        required:
        - weekly
        properties:
          weekly:
            $ref: '#/components/schemas/WeeklySchedule'
      - type: object
        required:
        - monthly
        properties:
          monthly:
            $ref: '#/components/schemas/MonthlySchedule'
    DailySchedule:
      type: object
      properties:
        time:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/UpgradeTime'
    GetAutoUpgradeStatusResponse:
      type: object
      required:
      - enabled
      properties:
        enabled:
          type: boolean
        last_execution:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/Timestamp'
        next_execution:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/Timestamp'
        schedule:
          oneOf:
          - type: 'null'
          - $ref: '#/components/schemas/AutoUpgradeSchedule'