Skip to content

The edition's activation view: current edition and preset, each add-on's state and each preset's add-on keys

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

Returns the edition’s activation view: current edition and preset, each add-on’s state (active, pending, available or console) with its family and its in-build and licence-covered facts, each preset’s add-on keys for the chooser, and the families an administrator turns on or off as a whole.

OK

Media type application/json
object
addons
required
Array<object>
object
env
required
string
family

The key of the family that sells the add-on.

string
in_build

The edition’s catalog has the add-on. Absent means not known; false is an observed absence.

boolean
key
required
string
license_covered

The verified licence covers it. Absent means not known; false is an observed absence.

boolean
needs_secret
boolean
preset
required
string
reason
string
state
required
string
Allowed values: active pending available console
summary
required
string
title
required
string
edition
required
string
families

The groups the edition sells add-ons in; each is turned on or off as a whole.

Array<object>
object
active
required

The add-ons of the family that are on now.

Array<string>
addons
required
Array<string>
key
required
string
title
required
string
preset
string
presets
required
Array<object>
object
addons
required
Array<string>
name
required
string
restart_required
required

A change already applied still needs an engine restart to take effect; false when the running engine follows it.

boolean
restarting
boolean
Example
{
"addons": [
{
"state": "active"
}
]
}

Bad request

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Unauthenticated

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Forbidden

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Not found

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Conflict / setup required

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Rate limited

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}