Save a board version
commit_board_uploadAfter the signed PUT succeeds, validate and save the KiCad upload as a new board or immutable version. Reuse prepare_board_upload's uploadId, operationId, policyHash, message, visibility and expected parent. The full uploaded file tree becomes the new version. A large save can answer state 'pending': it was accepted and is still running, so follow it with get_board_operation after retryAfterMs instead of committing again. On timeout use get_board_operation; retry the same commit, never invent a new operation ID. A head_moved error requires reading the newer version and reconciling changes before a fresh upload. Returns source persistence and rendering status separately with board/version URLs; saved does not mean rendered or reviewed.
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": {
"visibility": "<visibility>",
"operationId": "<operationId>",
"policyHash": "<policyHash>",
"message": "<message>",
"archiveProtocolVersion": "<archiveProtocolVersion>",
"uploadId": "<uploadId>"
},
"name": "commit_board_upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | What this version changes, at most 500 characters. Use the same text on prepare and commit. | |
| uploadId | Yes | uploadId returned by prepare_board_upload. | |
| projectId | No | Existing personal project ID from get_board_upload_requirements; omit to create a board. | |
| policyHash | Yes | policyHash from get_board_upload_requirements, unchanged. | |
| visibility | Yes | Explicit visibility acknowledgment: private_link for new boards (unlisted and accessible by link); exact current visibility for updates. This never changes visibility. | |
| operationId | Yes | A client-generated UUID. Reuse it for all retries of this exact upload; never reuse it for different files or metadata. | |
| archiveProtocolVersion | Yes | Confirm the packaging contract returned by get_board_upload_requirements. | |
| expectedParentVersionId | No | Required for an existing board: the head returned by get_board_upload_requirements. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||