Braiins

Braiins Authentication API

The Authentication API from Braiins — 2 operation(s) for authentication.

Documentation GitHub OpenAPI

Operations 2

PUT /api/v1/auth/password Set or remove user password #

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-authentication-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

openapi: 3.2.0
info:
  title: Braiins OS Public REST Authentication 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: Authentication
paths:
  /api/v1/auth/login:
    post:
      tags:
      - Authentication
      summary: User login
      description: Authenticates a user using their username and password. If the credentials are valid, a token is returned, which should be included in the `Authorization` header of subsequent requests.
      operationId: login
      requestBody:
        description: User login credentials, including username and password.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoginRequest'
            example:
              password: '1234'
              username: root
        required: true
      responses:
        '200':
          description: Successful login. Returns an authentication token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LoginResponse'
  /api/v1/auth/password:
    put:
      tags:
      - Authentication
      summary: Set or remove user password
      description: Allows a user to set or update their password. To remove the password, set the `password` field to `null`. This operation requires authentication.
      operationId: setPassword
      requestBody:
        description: Payload containing the new password. If the password field is null, the password will be removed.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetPasswordRequest'
            example:
              password: '1234'
        required: true
      responses:
        '204':
          description: Password successfully set or removed.
        '400':
          description: Invalid request payload.
        '401':
          description: Unauthorized. User must be authenticated.
        '500':
          description: Internal server error.
components:
  schemas:
    LoginRequest:
      type: object
      description: Request for login action.
      required:
      - username
      - password
      properties:
        password:
          type: string
        username:
          type: string
    SetPasswordRequest:
      type: object
      description: Request for set password action.
      properties:
        password:
          type:
          - string
          - 'null'
    LoginResponse:
      type: object
      description: Response for login action.
      required:
      - token
      - timeout_s
      properties:
        timeout_s:
          type: integer
          format: int32
          description: 'Authentication token validity/timeout in seconds.

            Token validity refreshed to this value with each request.'
          minimum: 0
        token:
          type: string
          description: Token to be used for authentication