Skip to content

First-run setup wizard progress

GET
/v1/console/setup-status
curl --request GET \
--url https://example.com/v1/console/setup-status \
--header 'Authorization: Bearer <token>'

Returns which first-run setup steps the deployment has completed, so the console wizard can resume onboarding at the right step.

OK

Media type application/json
object
completed
required
boolean
steps
required
Array<object>
object
applicable

Present and false ONLY for a step this build or deployment cannot complete. completed above is computed over the APPLICABLE steps, so one unwireable step does not report a finished install as unfinished.

boolean
completed
boolean
id
string
reason

Why the step is incomplete or not applicable. An incomplete step without a reason is a to-do item with no instructions.

string
Example generated
{
"completed": true,
"steps": [
{
"applicable": true,
"completed": true,
"id": "example",
"reason": "example"
}
]
}

Bad request

Media type application/json
object
error
required
object
code
required
string
message
required
string
Example generated
{
"error": {
"code": "example",
"message": "example"
}
}

Unauthenticated

Media type application/json
object
error
required
object
code
required
string
message
required
string
Example generated
{
"error": {
"code": "example",
"message": "example"
}
}

Forbidden

Media type application/json
object
error
required
object
code
required
string
message
required
string
Example generated
{
"error": {
"code": "example",
"message": "example"
}
}

Not found

Media type application/json
object
error
required
object
code
required
string
message
required
string
Example generated
{
"error": {
"code": "example",
"message": "example"
}
}

Conflict / setup required

Media type application/json
object
error
required
object
code
required
string
message
required
string
Example generated
{
"error": {
"code": "example",
"message": "example"
}
}

Rate limited

Media type application/json
object
error
required
object
code
required
string
message
required
string
Example generated
{
"error": {
"code": "example",
"message": "example"
}
}