---
title: "Create a new Maintenance Entry for the current user."
method: POST
path: "/api/PrinterMaintenance"
tags: ["PrinterMaintenance"]
---

# Create a new Maintenance Entry for the current user.

`POST /api/PrinterMaintenance`

## Request

- Base URL: `https://api.3dprintlog.com`
- URL: `https://api.3dprintlog.com/api/PrinterMaintenance`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://3dprintlog.auth0.com/authorize`, token URL `https://3dprintlog.auth0.com/oauth/token`)
  - API key in header `X-Api-Key`
  - API key in query parameter `api_key`

## Request body

- PrintLogApiModelsDTOsPrinterMaintenanceAddPrinterMaintenanceDto
  - `printerId` integer
  - `done` boolean
  - `date` string, date-time
  - `category` string, nullable
  - `description` string, nullable
  - `notes` string, nullable: Additional Notes about the maintenance entry
  - `priceValue` string, nullable: The value of the purchase price

## Response `201`

The filament detail DTO that was created.

- PrintLogApiModelsDTOsPrinterMaintenancePrinterMaintenanceDto
  - `id` string, uuid
  - `printerId` integer
  - `printer` PrintLogApiModelsDTOsPrinterPrinterSummary
    - `id` integer
    - `name` string, nullable
    - `make` string, nullable
    - `model` string, nullable
    - `isActive` boolean
    - `wattageW` number, double, nullable
    - `printTimeInSeconds` integer, nullable
    - `category` PrintLogApiModelsDTOsPrinterCategoryPrinterCategoryDto: The class/category/type of 3D printing technology, such as FDM, SLA, etc
      - `nickname` string, nullable: The nickname of the category
      - `name` string, nullable: The long form name of the category
      - `description` string, nullable: A description of that category
      - `materialCategory` PrintLogApiModelsDTOsMaterialCategoryMaterialCategoryDto: The category of materials, such as filament, resin, powder, etc.
        - `nickname` string, nullable: The nickname of the material category
        - `name` string, nullable: The long form name of the category
        - `description` string, nullable: A description of that category
        - `hasDiameter` boolean: Whether this material has a diameter
        - `showNozzleTemperature` boolean
        - `showBedTemperature` boolean
        - `showMeltingTemperature` boolean
        - `showRecommendedInitialLayerTimeInSeconds` boolean
        - `showRecommendedLayerTimeInSeconds` boolean
        - `showMaterialRefreshRatio` boolean: The percentage of new powder when mixing with old powder
        - `showInertGas` boolean
      - `showNozzleDiameter` boolean
      - `showFilamentDiameter` boolean
      - `showBeamDiameter` boolean
      - `showBedSize` boolean
      - `showScreenResolution` boolean
      - `showHasHeatedBed` boolean
      - `showHasHeatedChamber` boolean
  - `done` boolean
  - `date` string, date-time
  - `category` string, nullable
  - `description` string, nullable
  - `notes` string, nullable: Additional Notes about the maintenance entry
  - `priceValue` string, nullable: The value of the purchase price

## Other responses

- `401`: Returned if the request is not authenticated.
- `403`: Forbidden
- `404`: Returned if the printer does not exist or belongs to someone else.

---

[API](https://skmtc.dev/3dprintlog/apis/3d-print-log-api.md) · [All operations](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/llms.txt) · [OpenAPI document](https://skmtc.dev/3dprintlog/apis/3d-print-log-api/revisions/dfc3a4df4e38?raw)
