Extend the SimplyPrint API docs to include bed tagging and file updates#727

• would be nice to set the filament type, color, print bed, nozzlesize, per file

oftentimes the automatic matching doesn’t work. it would be nice to be able to control the matching via api while uploading trough our external tool. So we can make sure if we update a file through our tool it will have the same color etc. as before. We often make changes to the files but dont want to have to change the filament settings etc. every time as it is very error prone. It should work just on the first try.

You can certainly already do this, see “Tags”: https://apidocs.simplyprint.io/#tags

I believe bed type tagging is not documented yet, so we can take this in lieu of that suggestion.

You must be ai always working 24/7 hahaha. Love the effort!! Thank you. Can you tell me how to bed tagging works?

Haha thank you, no just cronically at work instead haha, waiting for AI to take over 👀

And is there also a way of adding the printers for the file via api? The specific one as well as the printer group?

That would be via the specific endpoints like https://apidocs.simplyprint.io/#update-queue-item etc

but that’s just for the queued items. I am talking about the api files

There is an UpdateFile endpoint as well, perhaps not documented i am noticing as well. You can figure it out by checking the request the UI makes when you do the action from there.

I took the liberty to rename this suggestion to indicate it needs to improve/update our API docs.

Great thanks! Just put claude code up to it, it will be done in no time :)

Is this done yet? I still need that? Is it maybe inside the mcp or something?

Yes, this is all live now:

Bed type tagging: https://apidocs.simplyprint.io/#assign-bed-type-tag - POST tags/Assign with “bedType”: {“type”: “textured_pei_plate”} (all built-in values here: https://apidocs.simplyprint.io/#bed-type-enum-reference), or {“type”: “custom”, “custom”: 2} for your own plates. To set it per file, use subject “type”: 3 with the file id - same goes for nozzle size and material type/color, see https://apidocs.simplyprint.io/#assign-tags-overview

Assigning printers to a file: https://apidocs.simplyprint.io/#update-file - files/UpdateFile takes “printers”, “printer_models” and “printer_groups” arrays, so both specific printers and printer groups work. Send an empty array to clear one.

And yes, it’s in our MCP server too - there are update_file and tag assignment tools there.