Blacksmith

Blacksmith Docker Builds

Accelerated Docker image builds via Blacksmith's BuildKit and the useblacksmith/build-push-action and useblacksmith/setup-docker-builder GitHub Actions, reusing cached layers on sticky disks to rebuild only what changed - up to 40x faster. Used as GitHub Actions in a workflow, not via a public REST API.

Documentation GitHub OpenAPI

Documentation

📖

Documentation

https://docs.blacksmith.sh/blacksmith-caching/docker-builds

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/blacksmith-sh/refs/heads/main/openapi/_original/blacksmith-sh-openapi.yml

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/docker-builds"

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.0.1
info:
  title: Blacksmith
  description: >-
    Blacksmith does not publish a documented, general-purpose public REST API.
    Blacksmith is consumed as a GitHub App and a set of GitHub Actions: you
    install the app for your organization at https://app.blacksmith.sh, change
    the `runs-on` tag in your workflow to a Blacksmith runner label (for
    example `blacksmith-2vcpu-ubuntu-2404`), and optionally add Blacksmith's
    cache and Docker-build Actions (such as `useblacksmith/cache`,
    `useblacksmith/build-push-action`, and `useblacksmith/setup-docker-builder`).
    Programmatic interaction with running CI jobs is provided through the
    Blacksmith Testbox CLI (`blacksmith testbox warmup|run|status`), and
    management/observability is provided through the web dashboard at
    app.blacksmith.sh. The docs site references an OpenAPI document at
    https://docs.blacksmith.sh/api-reference/openapi.json, but that resource
    is not publicly available (HTTP 404) as of this catalog date, so no
    operations are modeled here. This specification is intentionally left with
    no paths rather than fabricating endpoints. Re-check the api-reference and
    update on reconciliation if Blacksmith publishes a public API.
  termsOfService: https://docs.blacksmith.sh/about/terms-of-service
  contact:
    name: Blacksmith Support
    url: https://app.blacksmith.sh/?support=open
  version: '0.1'
servers:
  - url: https://app.blacksmith.sh
    description: >-
      Blacksmith web console and GitHub App surface. Not a documented REST API
      base path; listed for reference only.
paths: {}
components:
  securitySchemes:
    githubApp:
      type: oauth2
      description: >-
        Access to Blacksmith is authorized through the Blacksmith GitHub App
        installed on a GitHub organization, not via a public API key or bearer
        token. There is no documented machine-to-machine API auth scheme.
      flows:
        authorizationCode:
          authorizationUrl: https://github.com/apps/blacksmith
          tokenUrl: https://github.com/login/oauth/access_token
          scopes: {}