Wizard

Note

All wizard operations require either the ADMIN permission or the firstRun flag to be true.

Contents

• Wizard

  • Retrieve additional data about registered wizards

  • Finish wizards

  • Data model

    • Wizard data entry

Retrieve additional data about registered wizards

GET /setup/wizard

Retrieves additional data about the registered wizards.

Returns a 200 OK with an object mapping wizard identifiers to wizard data entries.

Finish wizards

POST /setup/wizard

Inform wizards that the wizard dialog has been finished.

Expects a JSON request body containing a property handled which holds a list of wizard identifiers which were handled (not skipped) in the wizard dialog.

Will call octoprint.plugin.WizardPlugin.on_wizard_finish() for all registered wizard plugins, supplying the information whether the wizard plugin’s identifier was within the list of handled wizards or not.

JSON Parameters

• handled – A list of handled wizards

Data model

Wizard data entry

Name	Multiplicity	Type	Description
required	1	bool	Whether the wizard needs to be run (true) or not (false)
details	1	object	Details for the wizard’s UI provided by the wizard plugin
version	1	int or null	Version of the wizard
ignored	1	bool	Whether the wizard has already been seen/is ignored (true) or not (false)