Prints

Replace a print's details.

Replaces the whole print rather than patching it: read the print with GET /api/Prints/{id}, change the fields you need, and send the whole object back. The last request wins.

put/api/Prints/{id}

Request

  • Base URL: https://api.3dprintlog.com
  • URL: https://api.3dprintlog.com/api/Prints/{id}
  • 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

Path parameters

idinteger required

The ID of the print to update.

Request body

idinteger

The Print's ID

titlestring required

The title of the print.

startDatestring date-time nullable
printerIdinteger

The printer id of the printer this print was printed on.

estimatedPrintTimeInSecondsinteger nullable

The estimated print duration in seconds.

estimatedFilamentUsageMginteger nullable

The non-tracked estimated Filament usage in milligrams. Used before the FilamentUsage collection was added.

printTimeInSecondsinteger nullable

The actual print duration in seconds.

filamentUsageMginteger nullable

The non-tracked Filament usage in milligrams. Used before the FilamentUsage collection was added.

filamentTypestring nullable

The non-tracked Filament Type. Used before the FilamentUsage collection was added.

notesstring nullable
urlstring nullable
fileNamestring nullable
allowCommentsboolean

Whether or not comments are allowed on this print.

allowFileDownloadsboolean

Whether or not file downloads are allowed on this print.

status1 | 2 | 3 | 4 | 5 | 6

Sent as an integer: 1 = Pending, 2 = Printing, 3 = Success, 4 = Cancelled, 5 = Failed, 6 = PartialSuccess.

viewStatus1 | 2 | 3

Sent as an integer: 1 = Public, 2 = Unlisted, 3 = Private.

projectIdstring uuid nullable

Assign to an existing project. Takes precedence over NewProjectName.

newProjectNamestring nullable

Create a new project inline and assign this print to it. Ignored if ProjectId is set.

Response

The newly-updated Print Detail information.

idinteger
titlestring nullable
startDatestring date-time nullable
printerIdinteger
estimatedPrintTimeInSecondsinteger nullable
estimatedFilamentUsageMginteger nullable
printTimeInSecondsinteger nullable
filamentUsageMginteger nullable

Filament usage in milligrams

filamentTypestring nullable
notesstring nullable
urlstring nullable
fileNamestring nullable
createdByUserIdinteger
allowCommentsboolean
allowFileDownloadsboolean
status1 | 2 | 3 | 4 | 5 | 6

Sent as an integer: 1 = Pending, 2 = Printing, 3 = Success, 4 = Cancelled, 5 = Failed, 6 = PartialSuccess.

viewStatus1 | 2 | 3

Sent as an integer: 1 = Public, 2 = Unlisted, 3 = Private.

projectIdstring uuid nullable
externalSourcestring nullable

The connector that logged this print, if any. Read-only; shown to the creator only.

externalIdstring nullable

The job's id in PrintLogApi.Models.DTOs.Print.PrintDetailDTO.ExternalSource. Read-only; shown to the creator only.

connectionDisplayNamestring nullable

The display name of the connection that logged this print, for "Logged automatically by …". Null when no connection logged it or it has been deleted. Shown to the creator only.

Changes

No recorded changes to this operation across all 1 revision of this API.