Skip to main content
PUT
Change a server's icon

Authorizations

Authorization
string
header
required

Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.

Path Parameters

server
string
required

The server UUID

Example:

"ecc6f4f1"

Body

application/json

Send a JSON object containing the fields below. Required fields are marked in the schema.

icon_url
enum<string> | null
required

The value of icon_url.

Available options:
https://img.icons8.com/color/48/ubuntu.png,
https://img.icons8.com/color/48/debian.png,
https://img.icons8.com/fluency/48/fedora.png,
https://img.icons8.com/color/48/arch-linux.png,
https://img.icons8.com/color/48/centos.png,
https://img.icons8.com/color/48/red-hat.png,
https://img.icons8.com/color/48/suse.png,
https://img.icons8.com/color/48/kali-linux.png,
https://img.icons8.com/color/48/free-bsd.png,
https://img.icons8.com/color/48/windows-10.png,
https://img.icons8.com/color/48/linux.png,
null

Response

The record, as a JSON object. There is no envelope.

The logo shown beside a server, answered after the icon form has changed it.

custom_icon_url
string | null
required

The customer's own override, or null when they have not made one.

Example:

"https://img.icons8.com/color/48/linux.png"

template_icon_url
string | null
required

The icon actually in force: the override, else the template's own.

Example:

"https://img.icons8.com/color/48/linux.png"