prepare_surface_upload¶
Reuse an already verified STL with this checksum, size, filename and units in the same project, or open its authenticated file picker.
Scope: artifacts:write. Catalogue annotation: Writes / prepares / submits work. Additional ownership and role checks may apply.
REST: POST /v1/artifacts/browser-uploads.
Arguments¶
Field |
Type / accepted values |
Required |
Default |
Constraints / meaning |
|---|---|---|---|---|
|
|
No |
|
Normally auto. STEP/STP/3MF use embedded units normalized to mm. STL units are resolved from measured bounds and supplied engineering context; ambiguous scale requires one clarification. |
|
string or null |
No |
|
maxLength: |
|
number or null |
No |
|
maximum: |
|
string (uuid) or null |
No |
|
|
|
string (uuid) or null |
No |
|
|
|
string |
Yes |
Omitted |
minLength: |
|
|
No |
|
|
|
|
No |
|
|
|
integer |
Yes |
Omitted |
maximum: |
|
string |
Yes |
Omitted |
pattern: |
Calling the tool¶
Use tools/call with this tool’s exact name and an arguments object matching the fields above. Get the complete live schema before supplying advanced controls:
{
"name": "get_tool_schema",
"arguments": {
"name": "prepare_surface_upload",
"include_definitions": false
}
}
Result and continuation¶
Inspect isError and structuredContent. Keep returned job, operation and artifact IDs. A pending operation_id is followed with get_operation; a compute job is followed with get_job. A wait timeout does not cancel work. Follow returned polling intervals and retain the same idempotency key when reconciling the same submission.
See agent workflow, jobs and operations, uploads, results and error recovery for the applicable lifecycle. MCP annotations describe tool behaviour; they are not blanket permission to run paid work or change account state.