Prepare a board upload
prepare_board_uploadReserve storage for a new KiCad board or version, after get_board_upload_requirements. A write: use only when the user asked to save this project to BoardRepo. New boards: name and visibility=private_link. Updates: projectId, expectedParentVersionId and the exact current visibility (updates to public boards are public). Returns a secret signed PUT URL for this one ZIP, valid 5 minutes: PUT the exact ZIP with the returned method/headers, no BoardRepo token, then commit_board_upload with the same metadata and operationId. Retry with the same operationId for a fresh URL. Never show or log it. Not saved until committed.
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>",
"expectedBytes": "<expectedBytes>",
"contentHash": "<contentHash>"
},
"name": "prepare_board_upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Required when creating a board; omit for an existing board. | |
| message | Yes | What this version changes, at most 500 characters. Use the same text on prepare and commit. | |
| 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. | |
| contentHash | Yes | SHA-256 of the exact ZIP bytes to upload, calculated in the assistant's workspace. | |
| operationId | Yes | A client-generated UUID. Reuse it for all retries of this exact upload; never reuse it for different files or metadata. | |
| expectedBytes | Yes | Exact byte length of the ZIP you will PUT. | |
| 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 | |||