Create board release
create_board_releaseCut a named release of a board you own: a name pinned to one exact published version, recording that version's fabrication outputs (gerbers, placement, BOM, schematic PDF, STEP) and retained source digest. Version omitted means the current head. Name rules (the tag argument): letters, digits, '.', '_' or '-'; never 'latest' or a bare/v-prefixed number, because those stay version selectors. This is a write; it needs save authority on the board. Retries reuse requestId: the same requestId and inputs return the existing release, different inputs conflict. A name already used on the board, even by a withdrawn release, reports release_tag_exists. The name and the version never change afterwards; the title and notes can be edited on the release page. To replace a release, withdraw it and create one under a new name.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"board": "<board>",
"requestId": "<requestId>",
"tag": "<tag>"
},
"name": "create_board_release"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | Yes | Release name: letters, digits, '.', '_' or '-', not 'latest' and not a bare or v-prefixed number (those are version selectors). | |
| board | Yes | A board you can read: handle/slug or a boardrepo.com URL. | |
| notes | No | Markdown release notes, rendered with the README sanitizer on the release page. | |
| title | No | Optional title shown on the release page, at most 120 characters. | |
| version | No | Which published version the release names: a number (3 or "v3"), a versionId from list_board_versions, or "latest". Omit for the current version. | |
| requestId | Yes | A client-generated UUID. Reuse it for all retries of this exact release; never reuse it for a different release. | |
| prerelease | No | Ignored. Releases no longer have a prerelease state; the field is accepted so older callers do not fail. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||