Bonsai

Bonsai Releases API

The Releases API from Bonsai — 2 operation(s) for releases.

Documentation GitHub OpenAPI

Operations 2

GET /releases View all available releases #

GET /releases/{slug} View a single release #

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/bonsai-io:bonsai-io-releases-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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: Bonsai Cloud Releases API
  version: alpha
  description: Bonsai REST API for managing clusters and exploring plans, releases and spaces. GENERATED by API Evangelist from the public documentation at https://bonsai.io/docs/api/ on 2026-10-14; this is not the provider's own document. Every operation carries x-source naming the page it was read from.
  contact:
    email: support@bonsai.io
  x-generated-from: documentation
  x-generated: '2026-10-14'
  x-generator: api-evangelist (hand-transcribed from docs, local-v5)
servers:
- url: https://api.bonsai.io
security:
- bearerAuth: []
- basicAuth: []
tags:
- name: Releases
paths:
  /releases:
    get:
      operationId: listReleases
      summary: View all available releases
      tags:
      - Releases
      x-source: https://bonsai.io/docs/api/endpoints/releases-api/
      responses:
        '200':
          description: Releases available to the account
          content:
            application/json:
              schema:
                type: object
                properties:
                  releases:
                    type: array
                    items:
                      $ref: '#/components/schemas/Release'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
  /releases/{slug}:
    parameters:
    - name: slug
      in: path
      required: true
      schema:
        type: string
      description: The release slug.
    get:
      operationId: getRelease
      summary: View a single release
      tags:
      - Releases
      x-source: https://bonsai.io/docs/api/endpoints/releases-api/
      responses:
        '200':
          description: The release
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Release'
        '404':
          $ref: '#/components/responses/NotFound'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: string
        status:
          type: integer
    Release:
      type: object
      properties:
        name:
          type: string
        slug:
          type: string
        version:
          type: string
        multitenant:
          type: boolean
  responses:
    Unauthorized:
      description: 'HTTP 401: Unauthorized'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: 'HTTP 404: Not Found'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: 'HTTP 403: Forbidden - token lacks the required scope'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: 'HTTP 429: Too Many Requests'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer bonsai_<key>_<secret>'
    basicAuth:
      type: http
      scheme: basic
      description: The token's key and secret as username and password.