✏️ Server Profile

Update Server Customization

Updates the profile customization settings for a server. Requires admin rights (validate_server_access).

KEIN PREMIUM-CHECK - und hier stand jahrelang das Gegenteil.

Der Docstring versprach "Requires admin rights AND an active premium status for the server". Im Code steht nur validate_server_access. Wer das gelesen und geglaubt hat, hielt eine Bezahlschranke fuer gesetzt, die es nie gab. (Aufgefallen im Nachtaudit 2026-08-09 bei A-005, dort als Widerlegung Nummer 4 vermerkt und nicht weiterverfolgt.)

GEAENDERT WURDE DER TEXT, NICHT DAS VERHALTEN, und das ist Absicht: eine Schranke nachzuruesten nimmt sie kostenlosen Servern weg, die diese Einstellungen heute benutzen. Das ist eine Preisentscheidung und keine Fehlerbehebung. Wenn sie fallen soll, gehoert sie ueber can_create / feature_limits gesetzt wie bei den uebrigen gemeterten Merkmalen - einen Eintrag dafuer gibt es dort bisher nicht.

GET /servers/{id}/profile liefert is_premium bereits mit, das Frontend koennte also heute schon anzeigen, was ein Upgrade brachte, ohne dass die API jemandem etwas wegnimmt.

put/api/v1/servers/{server_id}/profile/customization

Request

  • Base URL: https://api.notoq.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.notoq.xyz/api/v1/servers/{server_id}/profile/customization
  • Auth: HTTP bearer

Path parameters

server_idstring required

Discord Server ID

Request body

custom_textstring nullable

Server description or slogan.

descriptionstring nullable

Kurze Serverbeschreibung.

effectstring nullable

Effect (e.g. 'snow', 'confetti', 'default').

fontstring nullable

Preferred font.

heading_color_primarystring nullable

Primary color (Hex).

heading_color_secondarystring nullable

Secondary color for gradient.

background_image_base64string nullable

Background image as Base64.

updated_atstring date-time nullable

Last update

is_publicboolean

Ob der Server öffentlich gelistet ist (Invite/Liste).

Response

Successful Response

custom_textstring nullable

Server description or slogan.

descriptionstring nullable

Kurze Serverbeschreibung.

effectstring nullable

Effect (e.g. 'snow', 'confetti', 'default').

fontstring nullable

Preferred font.

heading_color_primarystring nullable

Primary color (Hex).

heading_color_secondarystring nullable

Secondary color for gradient.

background_image_base64string nullable

Background image as Base64.

updated_atstring date-time nullable

Last update

is_publicboolean

Ob der Server öffentlich gelistet ist (Invite/Liste).

Changes

No recorded changes to this operation across all 1 revision of this API.