Printago API
POST /v1/macros

Create GCODE macro

Requires: macro.create

Request Body

Macro details, including compatible printer models

GcodeMacroInsert
compatibilitiesoptional
object[]
max items: 500
modelNamerequired
string
vendorNamerequired
string
descriptionoptionalnullable
string
gcoderequired
string
namerequired
string
typerequired
"bed_clearing" | "purge" | "maintenance" | "generic"
bed_clearingpurgemaintenancegeneric

Example Request

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

Response Schema

EnhancedGcodeMacro
compatibilitiesrequired
object[]
modelNamerequired
string
vendorNamerequired
string
createdAtrequired
string
format: date-time
descriptionrequirednullable
string
gcoderequired
string
idrequired
string
pattern: ^[a-z0-9]{24}$
namerequired
string
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
typerequired
"bed_clearing" | "purge" | "maintenance" | "generic"
bed_clearingpurgemaintenancegeneric
updatedAtrequired
string
format: date-time

Example Response

201 OK — application/json 
{
  "name": "string",
  "description": "string",
  "type": "bed_clearing",
  "gcode": "string",
  "id": "string",
  "storeId": "string",
  "createdAt": "2025-01-15T12:00:00.000Z",
  "updatedAt": "2025-01-15T12:00:00.000Z",
  "compatibilities": [
    {
      "vendorName": "string",
      "modelName": "string"
    }
  ]
}