### Get Web Initialization Data

Source: https://app.printago.io/api/printago-api-swagger

Fetches initialization data required for the web application. This endpoint provides necessary configuration and setup information.

```json
{
  "/v1/web-init": {
    "get": {
      "tags": [],
      "parameters": [],
      "responses": {
        "200": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebInitData"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Start Print Job API

Source: https://app.printago.io/api/printago-api-swagger

Starts a print job. Requires a print job ID in the path and a request body to acknowledge the start. The response content is empty upon success.

```json
{
  "/v1/print-jobs/{id}/start": {
    "patch": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "schema": {
            "type": "string",
            "pattern": "^[a-z0-9]{24}$"
          },
          "required": true
        }
      ],
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/AcknowledgePrintJobStartRequest"
            }
          }
        },
        "required": true
      },
      "responses": {
        "200": {
          "content": {
            "application/json": {}
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Part Build Steps

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all part build steps. The response contains an array of PartBuildStep objects.

```json
{
  "schema": {
    "type": "array",
    "items": {
      "$ref": "#/components/schemas/PartBuildStep"
    }
  }
}
```

--------------------------------

### Get Compatible Profiles by Machine and Nozzle

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of compatible profiles based on machine model and nozzle diameter. Both parameters are required in the path.

```json
{
  "tags": [],
  "parameters": [
    {
      "name": "machineModel",
      "in": "path",
      "schema": {
        "type": "string"
      },
      "required": true
    },
    {
      "name": "nozzleDiameter",
      "in": "path",
      "schema": {
        "type": "string"
      },
      "required": true
    }
  ],
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/CompatibleProfiles"
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get SKU Builds

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all SKU builds. The response contains an array of SkuBuildWithRelation objects.

```json
{
  "schema": {
    "type": "array",
    "items": {
      "$ref": "#/components/schemas/SkuBuildWithRelation"
    }
  }
}
```

--------------------------------

### Get Materials

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all available materials. This endpoint is used to fetch information about supported printing materials.

```json
{
  "/v1/materials": {
    "get": {
      "tags": [],
      "parameters": [],
      "responses": {
        "200": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Material"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Part Builds

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all part builds. The response contains an array of PartBuildWithRelation objects.

```json
{
  "schema": {
    "type": "array",
    "items": {
      "$ref": "#/components/schemas/PartBuildWithRelation"
    }
  }
}
```

--------------------------------

### Get Part Build Step

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a specific part build step. This endpoint returns a 200 OK status with the part build step details in JSON format.

```json
{
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartBuildStep"
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Store Settings

Source: https://app.printago.io/api/printago-api-swagger

Retrieves the current store settings. This endpoint is used to fetch configuration details for a store.

```json
{
  "/v1/settings/store": {
    "get": {
      "tags": [],
      "parameters": [],
      "responses": {
        "200": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetStoreSettingsResponse"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Store Settings Response

Source: https://app.printago.io/api/printago-api-swagger

Represents the response structure for retrieving store settings. Includes ID, store ID, creation/update timestamps, and slicer information.

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "storeId": {
      "type": "string"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time"
    },
    "slicer": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string"
        }
      ]
    }
  },
  "required": [
    "id",
    "storeId",
    "createdAt",
    "updatedAt",
    "slicer"
  ]
}
```

--------------------------------

### Get Slicer Versions

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all available slicer versions. This endpoint is used to manage and view slicer software versions.

```json
{
  "/v1/settings/slicers": {
    "get": {
      "tags": [],
      "parameters": [],
      "responses": {
        "200": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetAllSlicerVersionsResponse"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get All Parts - Printago API

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all parts from the Printago API. This endpoint returns an array of Part objects.

```json
{
  "openapi": "3.1.0",
  "servers": [
    {
      "url": "https://api.printago.io",
      "description": "Prod"
    }
  ],
  "info": {
    "version": "0.0.1",
    "title": "@printago/api",
    "description": "",
    "license": {
      "name": "UNLICENSED"
    }
  },
  "paths": {
    "/v1/parts": {
      "get": {
        "tags": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Part"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Compatible Profiles by ID

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of compatible profiles for a given profile ID. This endpoint requires a valid profile ID as a path parameter.

```json
{
  "tags": [],
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "schema": {
        "type": "string",
        "pattern": "^[a-z0-9]{24}$"
      },
      "required": true
    }
  ],
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/CompatibleProfiles"
          }
        }
      }
    }
  }
}
```

--------------------------------

### Build Step Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the structure for a build step, including parameters, status, timestamps, and associated IDs. It specifies required fields like partBuildId, order, builder, inputFiles, status, logs, and identifiers such as id, storeId, createdAt, and updatedAt.

```json
{
  "type": "object",
  "properties": {
    "partBuildId": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "order": {
      "type": "integer",
      "minimum": 0
    },
    "builder": {
      "type": "string"
    },
    "inputFiles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1
    },
    "inputParameters": {
      "$ref": "#/components/schemas/OpenSCADInputParameters"
    },
    "inputHash": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string",
          "minLength": 1
        }
      ]
    },
    "cachedBuildStepId": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        }
      ]
    },
    "cachedOutputFile": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string"
        }
      ]
    },
    "outputFile": {
      "type": "string"
    },
    "status": {
      "oneOf": [
        {
          "const": "pending"
        },
        {
          "const": "running"
        },
        {
          "const": "success"
        },
        {
          "const": "error"
        },
        {
          "const": "cancelled"
        },
        {
          "const": "cached"
        },
        {
          "const": "force_running"
        }
      ]
    },
    "logs": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "requiresAssignedPrinter": {
      "type": "boolean"
    },
    "nextStepId": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        }
      ]
    },
    "startedAt": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string",
          "format": "date-time"
        }
      ]
    },
    "completedAt": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string",
          "format": "date-time"
        }
      ]
    },
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "storeId": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "partBuildId",
    "order",
    "builder",
    "inputFiles",
    "inputHash",
    "cachedBuildStepId",
    "cachedOutputFile",
    "outputFile",
    "status",
    "logs",
    "requiresAssignedPrinter",
    "nextStepId",
    "startedAt",
    "completedAt",
    "id",
    "storeId",
    "createdAt",
    "updatedAt"
  ]
}
```

--------------------------------

### Define BuildConfigV2 Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the configuration schema for creating a new build (BuildConfigV2). It allows specifying individual parts to print and SKUs (product bundles) to print, with options for quantity and linked part configurations.

```json
{
  "type": "object",
  "properties": {
    "parts": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PartBuildConfigV2"
      },
      "description": "Individual parts to print"
    },
    "skus": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/skuIdCuid2quantityQuantityundefinedlinkedPartConfigsRecordCuid2BasePartConfigV2undefined"
          },
          {
            "$ref": "#/components/schemas/skustringquantityQuantityundefinedlinkedPartConfigsRecordCuid2BasePartConfigV2undefined"
          }
        ]
      },
      "description": "SKUs (product bundles) to print"
    }
  },
  "description": "Configuration for creating a new build containing parts and/or SKUs"
}
```

--------------------------------

### Get All Printers

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all printers. This GET request returns an array of printer objects.

```json
{
  "/v1/printers": {
    "get": {
      "responses": {
        "200": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Printer"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Material Profiles (GET)

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all material profile assignments. The response is an array of MaterialProfileAssignment objects.

```json
{
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MaterialProfileAssignment"
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### API Schema: WebInitData

Source: https://app.printago.io/api/printago-api-swagger

Represents the initial data payload for web clients. It aggregates user permissions, subscription details, integration information, and available printer models.

```json
{
  "type": "object",
  "properties": {
    "permissions": {
      "$ref": "#/components/schemas/GetAllPermissionsForUserResponse"
    },
    "subscriptions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Subscription"
      }
    },
    "integrations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Integration"
      }
    },
    "myPrinterModels": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PrinterModel"
      }
    }
  },
  "required": [
    "permissions",
    "subscriptions",
    "integrations",
    "myPrinterModels"
  ]
}
```

--------------------------------

### Get Printer Slots (GET)

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all available printer slots. The response is an array of PrinterSlot objects.

```json
{
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PrinterSlot"
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Create Prints (Builds) - POST /v2/builds

Source: https://app.printago.io/api/printago-api-swagger

Creates prints by specifying parts and/or SKUs. This endpoint allows customization of quantities, parameters, materials, and other configuration options for each part or SKU. It returns a BuildResultV2 containing assigned IDs for created part and SKU builds.

```json
{
  "summary": "Create prints",
  "description": "Create prints containing parts and/or SKUs\n\nThis endpoint allows you to issue prints by specifying individual parts and/or complete SKUs (products).\nEach part or SKU can be customized with specific quantities, parameters, materials, and other configuration options.",
  "tags": [
    "builds"
  ],
  "parameters": [],
  "requestBody": {
    "description": "- Build configuration specifying parts and SKUs to include",
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/BuildConfigV2"
        }
      }
    },
    "required": true
  },
  "responses": {
    "201": {
      "description": "Result containing created part builds and SKU builds with their assigned IDs",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BuildResultV2"
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Printer Statistics

Source: https://app.printago.io/api/printago-api-swagger

Retrieves statistical data for printers. This GET request is used to fetch performance or usage metrics.

```json
{
  "/v1/printers/stats": {
    "get": {
      "responses": {
        "200": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Printer"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Order Item by ID

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a specific order item using its unique ID. This GET request is part of the orders API.

```json
{
  "get": {
    "tags": [
      "orders"
    ],
    "parameters": [
      {
        "name": "itemId",
        "in": "path",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        },
        "required": true
      }
    ],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/OrderItem"
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Base Part Configuration Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the base configuration options for parts within a build, including quantity, parameters, labels, tags, plate quantities, and material assignments.

```json
{
  "type": "object",
  "properties": {
    "quantity": {
      "type": "number",
      "minimum": 1,
      "maximum": 500,
      "title": "Number of copies to print",
      "description": "Number of copies to print."
    },
    "parameters": {
      "$ref": "#/components/schemas/Parameters",
      "description": "Custom parameters to override part defaults"
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024,
      "title": "Custom label for this part in the build",
      "description": "Custom label for this part in the build."
    },
    "tags": {
      "$ref": "#/components/schemas/Tags",
      "description": "Tags to categorize or filter this part"
    },
    "plateQuantities": {
      "$ref": "#/components/schemas/PartExtension3MFPlateQuantities",
      "description": "Quantity distribution across plates.  Only applies to 3MF and GCODE 3MF files"
    },
    "materials": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/components/schemas/RecordnumberArraySingleMaterialSpecification"
        }
      ],
      "description": "Material assignments per extruder/channel (channel index -> material specifications)"
    }
  },
  "description": "Base configuration options for parts in a build"
}
```

--------------------------------

### App Printago API: Basic Commands

Source: https://app.printago.io/api/printago-api-swagger

Defines the structure for basic commands such as 'stop', 'pause', 'resume', and 'resync-data'. These commands do not require additional parameters.

```json
{
  "command": "stop"
}
```

```json
{
  "command": "pause"
}
```

```json
{
  "command": "resume"
}
```

```json
{
  "command": "resync-data"
}
```

--------------------------------

### Get API Keys - GET /v1/api-keys

Source: https://app.printago.io/api/printago-api-swagger

Retrieves all API keys associated with a store. This endpoint is used to fetch the list of API keys.

```json
{
  "get": {
    "description": "Get all API keys for a store",
    "tags": [],
    "parameters": [],
    "responses": {}
  }
}
```

--------------------------------

### Get Order Items by Order ID

Source: https://app.printago.io/api/printago-api-swagger

Retrieves all order items associated with a specific order ID. This GET request is part of the orders API.

```json
{
  "get": {
    "tags": [
      "orders"
    ],
    "parameters": [
      {
        "name": "orderId",
        "in": "path",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        },
        "required": true
      }
    ],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/OrderItem"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Manage Materials - GET, PATCH, DELETE /v1/materials/{id}

Source: https://app.printago.io/api/printago-api-swagger

Handles operations for a specific material identified by its ID. Supports retrieving material details (GET), updating material information (PATCH), and deleting a material (DELETE). The ID is a 24-character hexadecimal string.

```json
{
  "get": {
    "tags": [],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        },
        "required": true
      }
    ],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Material"
            }
          }
        }
      }
    }
  },
  "patch": {
    "tags": [],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        },
        "required": true
      }
    ],
    "requestBody": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/UpdateMaterialRequest"
          }
        }
      },
      "required": true
    },
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Material"
            }
          }
        }
      }
    }
  },
  "delete": {
    "tags": [],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        },
        "required": true
      }
    ],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Process Profile Configuration

Source: https://app.printago.io/api/printago-api-swagger

Schema for process profile settings, including whether to use 3MF process profiles and if the job is arrangeable.

```json
{
  "use3MFProcessProfile": {
    "type": "boolean"
  },
  "arrangeable": {
    "type": "boolean"
  }
}
```

--------------------------------

### Get and Update Print Job API

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a specific print job by its ID or updates it with new partial data. Requires a print job ID in the path. The GET request returns the PrintJob object, while the PATCH request returns the updated PrintJob object.

```json
{
  "/v1/print-jobs/{id}": {
    "get": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "schema": {
            "type": "string",
            "pattern": "^[a-z0-9]{24}$"
          },
          "required": true
        }
      ],
      "responses": {
        "200": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PrintJob"
              }
            }
          }
        }
      }
    },
    "patch": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "schema": {
            "type": "string",
            "pattern": "^[a-z0-9]{24}$"
          },
          "required": true
        }
      ],
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PartialPrintJobInsert"
            }
          }
        },
        "required": true
      },
      "responses": {
        "200": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PrintJob"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Orders

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all orders. The response is an array of Order objects.

```json
{
  "get": {
    "tags": [
      "orders"
    ],
    "parameters": [],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Order"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Calibration Command

Source: https://app.printago.io/api/printago-api-swagger

Initiates a calibration process with an optional value. The 'calibration' command requires 'command' and 'option_value'.

```json
{
  "type": "object",
  "properties": {
    "command": {
      "const": "calibration"
    },
    "option_value": {
      "type": "number"
    }
  },
  "required": [
    "command",
    "option_value"
  ]
}
```

--------------------------------

### Create Build Configuration

Source: https://app.printago.io/api/printago-api-swagger

Creates a new build configuration. Requires a BuildConfig object in the request body and returns a 201 status code on success.

```json
{
  "/v1/builds": {
    "post": {
      "tags": [],
      "parameters": [],
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/BuildConfig"
            }
          }
        },
        "required": true
      },
      "responses": {
        "201": {
          "description": "",
          "content": {
            "application/json": {
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Subscription Information

Source: https://app.printago.io/api/printago-api-swagger

Retrieves information about the current subscription. Returns a Subscription object.

```json
{
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Subscription"
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Integrations

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all integrations. The response contains an array of Integration objects.

```json
{
  "schema": {
    "type": "array",
    "items": {
      "$ref": "#/components/schemas/Integration"
    }
  }
}
```

--------------------------------

### Part Build Step Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the schema for a single step within a part build process. It includes the build ID, step order, the builder used (e.g., slic3r, openscad), and input files.

```json
{
  "type": "object",
  "properties": {
    "partBuildId": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "order": {
      "type": "number",
      "minimum": 0
    },
    "builder": {
      "oneOf": [
        {
          "const": "slic3r"
        },
        {
          "const": "openscad"
        }
      ]
    },
    "inputFiles": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
```

--------------------------------

### Get All Stores

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all stores. The response contains an array of Store objects.

```json
{
  "/v1/stores": {
    "get": {
      "tags": [],
      "parameters": [],
      "responses": {
        "200": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Store"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Define PartBuildConfigV2 Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the schema for configuring a single part to be printed (PartBuildConfigV2). It includes the part ID (a 24-character hex string) and the quantity to print, with a minimum of 1 and a maximum of 500.

```json
{
  "type": "object",
  "properties": {
    "partId": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$",
      "description": "ID of the part to print"
    },
    "quantity": {
      "type": "number",
      "minimum": 1,
      "maximum": 500,
      "title": "Number of copies to print"
    }
  }
}
```

--------------------------------

### Connect Bambu Integration

Source: https://app.printago.io/api/printago-api-swagger

Connects to the Bambu integration. This is a POST request.

```json
{
  "post": {
    "tags": [],
    "parameters": [],
    "responses": {
      "201": {
        "description": "",
        "content": {
          "application/json": {}
        }
      }
    }
  }
}
```

--------------------------------

### Get Print Jobs

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all print jobs. This endpoint does not require any parameters.

```json
{
  "tags": [],
  "parameters": [],
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PrintJob"
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Part Configuration Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the configuration for a specific part, including quantity, custom parameters, labels, tags, plate quantities, and material assignments. It references other schemas for detailed specifications.

```json
{
  "type": "object",
  "properties": {
    "quantity": {
      "type": "number",
      "minimum": 1,
      "maximum": 500,
      "title": "Number of copies to print",
      "description": "Number of copies to print."
    },
    "parameters": {
      "$ref": "#/components/schemas/Parameters",
      "description": "Custom parameters to override part defaults"
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024,
      "title": "Custom label for this part in the build",
      "description": "Custom label for this part in the build."
    },
    "tags": {
      "$ref": "#/components/schemas/Tags",
      "description": "Tags to categorize or filter this part"
    },
    "plateQuantities": {
      "$ref": "#/components/schemas/PartExtension3MFPlateQuantities",
      "description": "Quantity distribution across plates.  Only applies to 3MF and GCODE 3MF files"
    },
    "materials": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/components/schemas/RecordnumberArraySingleMaterialSpecification"
        }
      ],
      "description": "Material assignments per extruder/channel (channel index -> material specifications)"
    }
  },
  "required": [
    "partId"
  ],
  "description": "Configuration for building a specific part"
}
```

--------------------------------

### Get Ignored SKUs

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of ignored SKUs. The response contains an IgnoredSku object.

```json
{
  "get": {
    "tags": [
      "orders"
    ],
    "parameters": [],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/IgnoredSku"
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### API Schema: Subscription

Source: https://app.printago.io/api/printago-api-swagger

Details a user's subscription plan, including concurrency slots, plan type ('core', 'personal'), trial end date, subscription term ('year', 'month'), commercial status, and associated IDs. Includes creation and update timestamps.

```json
{
  "type": "object",
  "properties": {
    "concurrencySlots": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "number",
          "minimum": 1
        }
      ]
    },
    "plan": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "const": "core"
        },
        {
          "const": "personal"
        }
      ]
    },
    "trialEndsAt": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string",
          "format": "date-time"
        }
      ]
    },
    "term": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "const": "year"
        },
        {
          "const": "month"
        }
      ]
    },
    "isCommercial": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "boolean"
        }
      ]
    },
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "storeId": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time"
    }
  }
}
```

--------------------------------

### Get Order Items

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all order items. The response is an array of OrderItem objects.

```json
{
  "get": {
    "tags": [
      "orders"
    ],
    "parameters": [],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/OrderItem"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Notification Settings

Source: https://app.printago.io/api/printago-api-swagger

Retrieves the current notification settings. Returns an array of NotificationSetting objects.

```json
{
  "get": {
    "tags": [],
    "parameters": [],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/NotificationSetting"
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Define Part Copy Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the structure for part copy information, including name, type, description, file URIs, file hashes, thumbnail URI, and parameters. Supports various file types like SCAD, STL, STEP, 3MF, and GCODE3MF.

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    },
    "type": {
      "oneOf": [
        {
          "const": "scad"
        },
        {
          "const": "stl"
        },
        {
          "const": "step"
        },
        {
          "const": "3mf"
        },
        {
          "const": "gcode3mf"
        }
      ]
    },
    "description": {
      "type": "string",
      "default": ""
    },
    "fileUris": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fileHashes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "thumbnailUri": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "string"
        }
      ]
    },
    "parameters": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "default": {
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "minLength": 0,
                "maxLength": 255
              },
              {
                "type": "boolean"
              }
            ]
          },
          "options": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "value": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    }
                  ]
                },
                "label": {
                  "type": "string"
                }
              },
              "required": [
                "value"
              ]
            }
          },
          "description": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          },
          "type": {
            "oneOf": [
              {
                "const": "number"
              },
              {
                "const": "string"
              },
              {
                "const": "boolean"
              }
            ]
          },
          "value": {
            "oneOf": [
              {
                "type": "number"
              },
              {
                "type": "string",
                "minLength": 0,
                "maxLength": 255
              },
              {
                "type": "boolean"
              }
            ]
          }
        },
        "required": [
          "name",
          "type"
        ]
      }
    }
  },
  "required": [
    "name",
    "type"
  ]
}
```

--------------------------------

### Define PartBuildConfig Schema

Source: https://app.printago.io/api/printago-api-swagger

Defines the schema for a PartBuildConfig, specifying properties like partId, quantity, label, tags, parameter overrides, extensions, and material assignments. It includes required fields for partId and quantity.

```json
{
  "type": "object",
  "properties": {
    "partId": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "skuBuildId": {
      "type": "string",
      "pattern": "^[a-z0-9]{24}$"
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    },
    "tags": {
      "$ref": "#/components/schemas/Tags"
    },
    "quantity": {
      "type": "number",
      "minimum": 0,
      "maximum": 500
    },
    "parameterOverrides": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PartParameterOverride"
      }
    },
    "extensions": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/components/schemas/PartBuildExtensions"
        }
      ]
    },
    "materialAssignments": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/components/schemas/RecordnumberArraySingleMaterialSpecification"
        }
      ]
    }
  },
  "required": [
    "partId",
    "quantity"
  ]
}
```

--------------------------------

### Get Stores API

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of stores. This endpoint is used to fetch store information.

```json
{
  "/v1/stores": {
    "get": {
      "tags": []
    }
  }
}
```

--------------------------------

### Import Bambu Profiles

Source: https://app.printago.io/api/printago-api-swagger

Imports profiles from Bambu integration. Returns a response conforming to BambuImportProfilesResponse schema.

```json
{
  "post": {
    "tags": [],
    "parameters": [],
    "responses": {
      "201": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/BambuImportProfilesResponse"
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get All Profiles

Source: https://app.printago.io/api/printago-api-swagger

Retrieves a list of all user profiles. Each profile object conforms to the Profile schema.

```json
{
  "/v1/profiles": {
    "get": {
      "tags": [],
      "parameters": [],
      "responses": {
        "200": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Profile"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

--------------------------------

### Get Printer by ID

Source: https://app.printago.io/api/printago-api-swagger

Retrieves detailed information about a specific printer using its unique ID.

```json
{
  "get": {
    "tags": [],
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9]{24}$"
        },
        "required": true
      }
    ],
    "responses": {
      "200": {
        "description": "",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Printer"
            }
          }
        }
      }
    }
  }
}
```