---
title: "Build a plugin"
method: POST
path: "/api/v1beta/plugins/build"
tags: ["plugins"]
---

# Build a plugin

`POST /api/v1beta/plugins/build`

Build a plugin from a local directory

## Request body

- union
  - object
  - PkgApiV1BuildPluginRequest — Request to build a plugin from a local directory
    - `path` string — Path to the plugin definition directory
    - `tag` string — OCI tag for the built artifact

## Response `200`

OK

- GithubComStacklokToolhivePkgPluginsBuildResult
  - `reference` string — Reference is the OCI reference of the built skill artifact.

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/stacklok/apis/toolhive-api.md) · [All operations](https://skmtc.dev/stacklok/apis/toolhive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacklok/toolhive-api/revisions/e9f942effcda/schema)