Printer Config

Operations for managing printer configurations. Requires Cloud Slicer Token

Get Printer Configs

GET

https://api.cloudslicer3d.com

/v1/printer

Bearer

Get all of the authenticated user's printer configurations.

Get Printer Configs › Responses

Successfully retrieved printer configurations

PrinterConfigResponse[]

PrinterConfigResponse

user_id

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required

Create Printer Config

POST

https://api.cloudslicer3d.com

/v1/printer

Bearer

Create a printer configuration including general settings, machine limits, and extruder settings.

Create Printer Config › Request Body

Create a printer configuration including general settings, machine limits, and extruder settings.

PrinterConfig

Create Printer Config › Responses

Successfully created printer configuration

CreatePrinterConfigResponse

user_id

string · required

status

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required

POST/v1/printer

curl https://api.cloudslicer3d.com/v1/printer \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "general": {
    "name": "Default Printer",
    "printer_model": "Generic Printer",
    "printer_variant": "0.4",
    "printer_structure": "corexy",
    "bed_size_x": 200,
    "bed_size_y": 200,
    "max_print_z": 250,
    "origin": [
      0,
      0
    ],
    "z_offset": 0,
    "gcode_flavor": "marlin",
    "use_relative_e_distances": false,
    "use_firmware_retraction": false,
    "silent_mode": false
  },
  "machine_limits": {
    "max_feedrates": {
      "x": 200,
      "y": 200,
      "z": 5,
      "e": 25
    },
    "max_accelerations": {
      "x": 1000,
      "y": 1000,
      "z": 100,
      "e": 5000,
      "extruding": 5000,
      "retracting": 5000,
      "travel": 9000
    },
    "max_jerks": {
      "x": 8,
      "y": 8,
      "z": 0.4,
      "e": 5
    },
    "min_feedrates": {
      "extruding_rate": 0,
      "travel_rate": 0
    }
  },
  "extruder": {
    "nozzle_diameter": 0.4,
    "layer_height_min": 0.1,
    "layer_height_max": 0.3
  },
  "retraction": {
    "length": 0.8,
    "speed": 30,
    "deretract_speed": 30,
    "lift_z": 0.4,
    "lift_above": 0,
    "lift_below": 249,
    "wipe": true,
    "wipe_distance": 2,
    "retract_before_wipe": "0%",
    "minimum_travel": 1,
    "retract_on_layer_change": true
  },
  "clearance": {
    "extruder_clearance_height": 34,
    "extruder_clearance_radius": 68
  }
}'

Example Request Body

{
  "general": {
    "name": "Default Printer",
    "printer_model": "Generic Printer",
    "printer_variant": "0.4",
    "printer_structure": "corexy",
    "bed_size_x": 200,
    "bed_size_y": 200,
    "max_print_z": 250,
    "origin": [
      0,
      0
    ],
    "z_offset": 0,
    "gcode_flavor": "marlin",
    "use_relative_e_distances": false,
    "use_firmware_retraction": false,
    "silent_mode": false
  },
  "machine_limits": {
    "max_feedrates": {
      "x": 200,
      "y": 200,
      "z": 5,
      "e": 25
    },
    "max_accelerations": {
      "x": 1000,
      "y": 1000,
      "z": 100,
      "e": 5000,
      "extruding": 5000,
      "retracting": 5000,
      "travel": 9000
    },
    "max_jerks": {
      "x": 8,
      "y": 8,
      "z": 0.4,
      "e": 5
    },
    "min_feedrates": {
      "extruding_rate": 0,
      "travel_rate": 0
    }
  },
  "extruder": {
    "nozzle_diameter": 0.4,
    "layer_height_min": 0.1,
    "layer_height_max": 0.3
  },
  "retraction": {
    "length": 0.8,
    "speed": 30,
    "deretract_speed": 30,
    "lift_z": 0.4,
    "lift_above": 0,
    "lift_below": 249,
    "wipe": true,
    "wipe_distance": 2,
    "retract_before_wipe": "0%",
    "minimum_travel": 1,
    "retract_on_layer_change": true
  },
  "clearance": {
    "extruder_clearance_height": 34,
    "extruder_clearance_radius": 68
  }
}

json

application/json

Example Responses

{
  "user_id": "user_id",
  "status": "status",
  "printer_id": "printer_id",
  "printer_name": "printer_name",
  "timestamp": "timestamp"
}

json

application/json

Get Printer Config

GET

https://api.cloudslicer3d.com

/v1/printer/{printer_id}

Bearer

Get a specific printer configuration for the authenticated user.

Get Printer Config › path Parameters

printer_id

string · required

ID for the printer configuration to retrieve.

Get Printer Config › Responses

Successfully retrieved printer configuration

SinglePrinterConfigResponse

user_id

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required

object · required

Delete Printer Config

DELETE

https://api.cloudslicer3d.com

/v1/printer/{printer_id}

Bearer

Delete a specific printer configuration for the authenticated user.

Delete Printer Config › path Parameters

printer_id

string · required

ID for the printer configuration to delete.

Delete Printer Config › Responses

Successfully deleted printer configuration

DeletePrinterConfigResponse

user_id

string · required

status

string · required

printer_id

string · required

timestamp

string · required

Update Printer Config

PATCH

https://api.cloudslicer3d.com

/v1/printer/{printer_id}

Bearer

Update an existing printer configuration for the authenticated user.

Update Printer Config › path Parameters

printer_id

string · required

ID for the printer configuration to update.

Update Printer Config › Request Body

Complete printer configuration including general settings, machine limits, and extruder settings.

PrinterConfig

Update Printer Config › Responses

Successfully updated printer configuration

UpdatePrinterConfigResponse

user_id

string · required

status

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required

PATCH/v1/printer/{printer_id}

curl https://api.cloudslicer3d.com/v1/printer/:printer_id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "general": {
    "name": "Default Printer",
    "printer_model": "Generic Printer",
    "printer_variant": "0.4",
    "printer_structure": "corexy",
    "bed_size_x": 200,
    "bed_size_y": 200,
    "max_print_z": 250,
    "origin": [
      0,
      0
    ],
    "z_offset": 0,
    "gcode_flavor": "marlin",
    "use_relative_e_distances": false,
    "use_firmware_retraction": false,
    "silent_mode": false
  },
  "machine_limits": {
    "max_feedrates": {
      "x": 200,
      "y": 200,
      "z": 5,
      "e": 25
    },
    "max_accelerations": {
      "x": 1000,
      "y": 1000,
      "z": 100,
      "e": 5000,
      "extruding": 5000,
      "retracting": 5000,
      "travel": 9000
    },
    "max_jerks": {
      "x": 8,
      "y": 8,
      "z": 0.4,
      "e": 5
    },
    "min_feedrates": {
      "extruding_rate": 0,
      "travel_rate": 0
    }
  },
  "extruder": {
    "nozzle_diameter": 0.4,
    "layer_height_min": 0.1,
    "layer_height_max": 0.3
  },
  "retraction": {
    "length": 0.8,
    "speed": 30,
    "deretract_speed": 30,
    "lift_z": 0.4,
    "lift_above": 0,
    "lift_below": 249,
    "wipe": true,
    "wipe_distance": 2,
    "retract_before_wipe": "0%",
    "minimum_travel": 1,
    "retract_on_layer_change": true
  },
  "clearance": {
    "extruder_clearance_height": 34,
    "extruder_clearance_radius": 68
  }
}'

Example Request Body

{
  "general": {
    "name": "Default Printer",
    "printer_model": "Generic Printer",
    "printer_variant": "0.4",
    "printer_structure": "corexy",
    "bed_size_x": 200,
    "bed_size_y": 200,
    "max_print_z": 250,
    "origin": [
      0,
      0
    ],
    "z_offset": 0,
    "gcode_flavor": "marlin",
    "use_relative_e_distances": false,
    "use_firmware_retraction": false,
    "silent_mode": false
  },
  "machine_limits": {
    "max_feedrates": {
      "x": 200,
      "y": 200,
      "z": 5,
      "e": 25
    },
    "max_accelerations": {
      "x": 1000,
      "y": 1000,
      "z": 100,
      "e": 5000,
      "extruding": 5000,
      "retracting": 5000,
      "travel": 9000
    },
    "max_jerks": {
      "x": 8,
      "y": 8,
      "z": 0.4,
      "e": 5
    },
    "min_feedrates": {
      "extruding_rate": 0,
      "travel_rate": 0
    }
  },
  "extruder": {
    "nozzle_diameter": 0.4,
    "layer_height_min": 0.1,
    "layer_height_max": 0.3
  },
  "retraction": {
    "length": 0.8,
    "speed": 30,
    "deretract_speed": 30,
    "lift_z": 0.4,
    "lift_above": 0,
    "lift_below": 249,
    "wipe": true,
    "wipe_distance": 2,
    "retract_before_wipe": "0%",
    "minimum_travel": 1,
    "retract_on_layer_change": true
  },
  "clearance": {
    "extruder_clearance_height": 34,
    "extruder_clearance_radius": 68
  }
}

json

application/json

Example Responses

{
  "user_id": "user_id",
  "status": "status",
  "printer_id": "printer_id",
  "printer_name": "printer_name",
  "timestamp": "timestamp"
}

json

application/json

Account Filament Config

Get Printer Configs

GET

https://api.cloudslicer3d.com

/v1/printer

Bearer

Get all of the authenticated user's printer configurations.

Get Printer Configs › Responses

Successfully retrieved printer configurations

PrinterConfigResponse[]

PrinterConfigResponse

user_id

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required

Create Printer Config

POST

https://api.cloudslicer3d.com

/v1/printer

Bearer

Create a printer configuration including general settings, machine limits, and extruder settings.

Create Printer Config › Request Body

Create a printer configuration including general settings, machine limits, and extruder settings.

PrinterConfig

Create Printer Config › Responses

Successfully created printer configuration

CreatePrinterConfigResponse

user_id

string · required

status

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required

Get Printer Config

GET

https://api.cloudslicer3d.com

/v1/printer/{printer_id}

Bearer

Get a specific printer configuration for the authenticated user.

Get Printer Config › path Parameters

printer_id

string · required

ID for the printer configuration to retrieve.

Get Printer Config › Responses

Successfully retrieved printer configuration

SinglePrinterConfigResponse

user_id

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required

object · required

Delete Printer Config

DELETE

https://api.cloudslicer3d.com

/v1/printer/{printer_id}

Bearer

Delete a specific printer configuration for the authenticated user.

Delete Printer Config › path Parameters

printer_id

string · required

ID for the printer configuration to delete.

Delete Printer Config › Responses

Successfully deleted printer configuration

DeletePrinterConfigResponse

user_id

string · required

status

string · required

printer_id

string · required

timestamp

string · required

Update Printer Config

PATCH

https://api.cloudslicer3d.com

/v1/printer/{printer_id}

Bearer

Update an existing printer configuration for the authenticated user.

Update Printer Config › path Parameters

printer_id

string · required

ID for the printer configuration to update.

Update Printer Config › Request Body

Complete printer configuration including general settings, machine limits, and extruder settings.

PrinterConfig

Update Printer Config › Responses

Successfully updated printer configuration

UpdatePrinterConfigResponse

user_id

string · required

status

string · required

printer_id

string · required

printer_name

string · required

timestamp

string · required