Printago API
PATCH /v1/macros/{id}

Update GCODE macro

The macro's type is immutable after creation.

Requires: macro.edit

Path Parameters

id required
string
Macro ID

Request Body

Fields to update

GcodeMacroUpdate
compatibilitiesoptional
object[]
max items: 500
modelNamerequired
string
vendorNamerequired
string
descriptionoptional
string
gcodeoptional
string
nameoptional
string

Example Request

application/json
{
  "name": "string",
  "gcode": "string",
  "compatibilities": [
    {
      "vendorName": "string",
      "modelName": "string"
    }
  ]
}

Response Schema

EnhancedGcodeMacro
compatibilitiesrequired
object[]
modelNamerequired
string
vendorNamerequired
string
createdAtrequired
string
format: date-time
descriptionrequired
string
gcoderequired
string
idrequired
string
pattern: ^[a-z0-9]{24}$
namerequired
string
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
typerequired
any
updatedAtrequired
string
format: date-time

Example Response

200 OK — application/json
{
  "name": "string",
  "gcode": "string",
  "id": "string",
  "storeId": "string",
  "createdAt": "2026-08-24T03:58:55.508Z",
  "updatedAt": "2026-08-24T03:58:55.508Z",
  "compatibilities": [
    {
      "vendorName": "string",
      "modelName": "string"
    }
  ]
}