Skip to content

Advance the wizard step

PATCH
/setup/state
curl --request PATCH \
--url https://example.com/api/v1/setup/state \
--header 'Content-Type: application/json' \
--data '{ "currentStep": "welcome" }'

Advances the wizard to the given step. Rejects steps outside the known wizard sequence.

Media typeapplication/json

Advance the wizard to the given step

object
currentStep
required

Ordered setup wizard step

string
Allowed values: welcome connect-arr link-database select-profiles preview-sync done

Wizard state updated

Media typeapplication/json
object
wizard
required
object
completed
required

Whether the wizard has been marked completed

boolean
dismissedAt
required

Timestamp the wizard was dismissed, or null if never dismissed

string format: date-time
nullable
currentStep
required

Ordered setup wizard step

string
Allowed values: welcome connect-arr link-database select-profiles preview-sync done
Example
{
"wizard": {
"currentStep": "welcome"
}
}

Missing or invalid currentStep

Media typeapplication/json
object
error
required

Error message

string
Examplegenerated
{
"error": "example"
}

Setup has already been completed or dismissed