API-Dokumentation

Webspace-API: Hosting, CMS und Domains

Webspaces erstellen, upgraden und kündigen, ein CMS installieren, PHP umschalten und Domains verknüpfen, per Sitequest REST-API.

Webspace-Preise

Webspace-Pakete, Kontingente und Feature-Preise abfragen.

Erforderlicher Scope: —

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "free": { "diskGb": 1, "databases": 1, "bandwidthGb": 10, "allowedDomains": 1, "price": 0 },
    "tiers": [
      { "diskGb": 5,  "monthly": 4.99, "yearly": 49.90 },
      { "diskGb": 10, "monthly": 7.99, "yearly": 79.90 }
    ],
    "addons": { "databasePerUnit": 0.50, "domainPerUnit": 1.00 }
  }
}

Antwortfelder

Feld Typ Beschreibung
free object Kontingente der kostenlosen Stufe (einmalig pro Nutzer).
tiers array Bezahlpakete mit Monats- und Jahrespreis.
addons object Aufpreis pro Einheit für Datenbanken und Custom-Domains.

Beispiel

curl https://site.quest/api/v1/webspaces/pricing

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.

Webspace erstellen

Bezahlten Webspace bereitstellen — belastet die hinterlegte Zahlungsfreigabe.

Erforderlicher Scope: webspace:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body

Parameter Erforderlich Beschreibung
diskGb Ja Plattenplatz in GB (5–500).
databases Ja Anzahl MariaDB-Datenbanken (10–50).
cms Nein STATIC (Standard), WORDPRESS, JOOMLA, DRUPAL, TYPO3.
interval Nein 1 month (Standard) oder 12 months.
name Nein Anzeigename.

Antwort

{
  "data": {
    "orderId": "507f1f77bcf86cd799439011",
    "orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "diskGb": 10,
    "databases": 10,
    "cms": "WORDPRESS",
    "interval": "1 month",
    "status": "completed",
    "paymentId": "tr_abc123"
  }
}

Antwortfelder

Feld Typ Beschreibung
orderId / orderToken string Mit diesen Werten kann Bestellstatus abgefragt werden.
status string completed, payment_pending oder payment_failed.

Fehler

Status Code Beschreibung
400 INVALID_DISK diskGb fehlt oder ist außerhalb des Bereichs.
400 INVALID_DATABASES databases fehlt oder ist außerhalb des Bereichs.
400 INVALID_CMS cms ist kein erlaubter Wert.
403 no_valid_mandate Keine hinterlegte Zahlungsfreigabe.
403 account_suspended Konto ist gesperrt.

Beispiel

curl -X POST https://site.quest/api/v1/webspaces/create \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "diskGb": 10, "databases": 10, "cms": "WORDPRESS", "interval": "1 month" }'

MCP

Diese Aktion ist auch über das create_webspace MCP-Tool verfügbar.

Kostenlosen Webspace aktivieren

Den einmaligen Free-Tier-Webspace beanspruchen. Keine Abrechnung.

Erforderlicher Scope: webspace:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body

Parameter Erforderlich Beschreibung
cms Nein Initial zu installierendes CMS. Standard STATIC.

Antwort

{
  "data": {
    "id": "69e80ac118f081032f3b0416",
    "subdomain": "ws-0862c.sitequest.eu",
    "cms": "STATIC",
    "isFree": true,
    "status": "completed"
  }
}

Antwortfelder

Feld Typ Beschreibung
subdomain string Automatisch generierter *.sitequest.eu-Hostname.

Fehler

Status Code Beschreibung
409 ALREADY_CLAIMED Nutzer hat seinen Free-Webspace bereits aktiviert.
403 ACCOUNT_SUSPENDED Konto ist gesperrt.

Beispiel

curl -X POST https://site.quest/api/v1/webspaces/free \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "cms": "WORDPRESS" }'

MCP

Diese Aktion ist auch über das webspace_claim_free MCP-Tool verfügbar.

Webspaces auflisten

Alle Webspaces auflisten, auf die der API-Schlüssel Zugriff hat.

Erforderlicher Scope: webspace:read

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": [
    {
      "id": "69e80ac118f081032f3b0416",
      "name": "My Blog",
      "subdomain": "my-blog.sitequest.eu",
      "customDomain": null,
      "status": "ACTIVE",
      "cms": "WORDPRESS",
      "cmsVersion": "6.5",
      "phpVersion": "8.3",
      "isFree": false,
      "region": "eu-central",
      "diskSpaceGb": 5,
      "diskUsageGb": 0.42,
      "bandwidthGb": 100,
      "bandwidthUsageGb": 1.25,
      "databases": 10,
      "databasesUsed": 1,
      "linkedDomains": 1,
      "createdAt": "2026-04-01T12:34:56.000Z"
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
id string Webspace-ID.
subdomain string Die zugewiesene *.sitequest.eu-Hostname.
status string ACTIVE, SUSPENDED, INSTALLING, FAILED.
cms string Installiertes CMS: STATIC, WORDPRESS, JOOMLA, DRUPAL, TYPO3.
phpVersion string Aktive PHP-Version (8.1–8.5).
isFree boolean true, wenn über die Free-Tier-Endpoint beansprucht.
diskSpaceGb / bandwidthGb number Zugewiesener Speicherplatz und monatliche Bandbreite in GB.
diskUsageGb / bandwidthUsageGb number Zwischengespeicherte Verbrauchszähler in GB.

Beispiel

curl https://site.quest/api/v1/webspaces \
  -H "Authorization: Bearer sq_live_..."

MCP

Diese Aktion ist auch über das list_webspaces MCP-Tool verfügbar.

Webspace abrufen

Detailansicht eines Webspaces inkl. verknüpfter Domains und Live-Plattenverbrauch.

Erforderlicher Scope: webspace:read

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "id": "69e80ac118f081032f3b0416",
    "name": "My Blog",
    "subdomain": "my-blog.sitequest.eu",
    "customDomain": null,
    "systemUser": "ws_0862c",
    "status": "ACTIVE",
    "cms": "WORDPRESS",
    "phpVersion": "8.3",
    "region": "eu-central",
    "nodeName": "node-bf015",
    "diskSpaceGb": 5,
    "diskUsageGb": 0.42,
    "diskUsageGbCached": 0.4,
    "bandwidthGb": 100,
    "bandwidthUsageGb": 1.25,
    "databases": 10,
    "databasesUsed": 1,
    "linkedDomains": [
      { "id": "69ee...", "domain": "blog.example.com", "sslActive": true, "sslExpiry": "2027-04-22T00:00:00.000Z" }
    ],
    "sslExpiry": "2027-04-22T00:00:00.000Z",
    "createdAt": "2026-04-01T12:34:56.000Z",
    "updatedAt": "2026-04-22T12:34:56.000Z"
  }
}

Antwortfelder

Feld Typ Beschreibung
systemUser string Der Linux-User (ws_<slug>) für SSH/SFTP-Login.
diskUsageGb number Live-Plattenverbrauch in GB (fällt bei Fehler auf gespeicherten Wert zurück).
diskUsageGbCached number Zuletzt gespeicherter Plattenverbrauch in GB.
linkedDomains array An diesen Webspace gebundene Custom-Domains, inkl. SSL-Status.

Beispiel

curl https://site.quest/api/v1/webspaces/69e80ac118f081032f3b0416 \
  -H "Authorization: Bearer sq_live_..."

MCP

Diese Aktion ist auch über das get_webspace MCP-Tool verfügbar.

Verbindungsinformationen

SSH/SFTP-Verbindungsdetails inkl. Hostname, Port, User, Host-Key-Fingerprint und einem ~/.ssh/config-Snippet.

Erforderlicher Scope: webspace:read

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "host": "ws-0862c.sitequest.eu",
    "ip": "45.84.196.148",
    "port": 22,
    "username": "ws_0862c",
    "hostKeyFingerprint": "SHA256:abcd1234...",
    "sshConfigSnippet": "Host ws-0862c\n  HostName ws-0862c.sitequest.eu\n  User ws_0862c\n  Port 22\n  IdentityFile ~/.ssh/id_ed25519",
    "sshExample":  "ssh -p 22 ws_0862c@ws-0862c.sitequest.eu",
    "sftpExample": "sftp -P 22 ws_0862c@ws-0862c.sitequest.eu"
  }
}

Antwortfelder

Feld Typ Beschreibung
hostKeyFingerprint string | null SHA-256-Fingerprint live via ssh-keyscan (best-effort, kann null sein).
sshConfigSnippet string Snippet zum Einfügen in ~/.ssh/config.

Beispiel

curl https://site.quest/api/v1/webspaces/69e80ac1.../connection-info \
  -H "Authorization: Bearer sq_live_..."

MCP

Diese Aktion ist auch über das webspace_get_ssh_info MCP-Tool verfügbar.

Webspace erweitern

Plattenplatz oder Datenbankanzahl erhöhen. Downgrades sind nicht erlaubt.

Der anteilige Betrag wird über dein hinterlegtes Zahlungsmittel abgebucht. Die neuen Limits gelten, sobald die Zahlung bestätigt ist, und die monatlichen Kosten steigen entsprechend. Den Stand der Bestellung liefert orderId.

Erforderlicher Scope: webspace:scale

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body

Parameter Erforderlich Beschreibung
diskGb Nein Neuer Plattenplatz in GB. Muss ≥ aktuell sein.
databases Nein Neue Datenbankanzahl. Muss ≥ aktuell sein.

Antwort

{
  "data": {
    "id": "69e80ac118f081032f3b0416",
    "subdomain": "ws-0862c.sitequest.eu",
    "orderId": "69e80ac118f081032f3b0420",
    "paymentId": "tr_7UhSN1zuXS",
    "status": "payment_pending",
    "immediateCost": 2.15,
    "newMonthlyAmount": 4.5,
    "requested": { "diskGb": 10, "databases": 15 }
  }
}

Fehler

Status Code Beschreibung
400 DOWNGRADE_NOT_ALLOWED Angeforderter Wert liegt unter dem aktuellen.
400 NO_CHANGES Body fordert keine Änderungen.
403 SPENDING_LIMIT_EXCEEDED Das Upgrade überschreitet das Ausgabenlimit dieses API-Schlüssels.
403 NOT_BILLING_OWNER Nur der Eigentümer des Abos kann den Webspace erweitern.
409 DUPLICATE_UPGRADE Für diesen Webspace läuft bereits ein Upgrade.
409 FREE_TIER_IMMUTABLE Free-Webspaces können nicht erweitert werden — löschen und als bezahlt neu erstellen.

Beispiel

curl -X PATCH https://site.quest/api/v1/webspaces/69e80ac118f081032f3b0416 \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "diskGb": 20 }'

MCP

Diese Aktion ist auch über das webspace_upgrade MCP-Tool verfügbar. Dort muss confirm auf true gesetzt sein.

Webspace umbenennen

Aktualisiere den Anzeigenamen eines Webspaces. Dies ist ein lokaler Vorgang und hat keine Auswirkung auf die Subdomain oder Bereitstellung.

Erforderlicher Scope: webspace:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Webspace-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
name string Ja Neuer Anzeigename (1–255 Zeichen)
{
  "name": "Mein Portfolio"
}

Antwort

{
  "data": {
    "name": "Mein Portfolio",
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
name string Der neue Anzeigename
success boolean Ob die Umbenennung erfolgreich war

Fehler

Status Code Beschreibung
400 INVALID_NAME Der Name muss 1–255 Zeichen lang sein
400 INVALID_BODY Der Anfragekörper ist kein gültiges JSON
404 NOT_FOUND Webspace nicht gefunden oder kein Zugriff

Beispiel

curl -X POST "https://site.quest/api/v1/webspaces/69e80ac118f081032f3b0416/rename" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"name": "Mein Portfolio"}'

MCP

Diese Aktion ist auch über das webspace_set_label MCP-Tool verfügbar.

PHP-Version ändern

PHP-Version des Webspace-vhosts wechseln. Startet OpenLiteSpeed neu (graceful).

Erforderlicher Scope: webspace:manage

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body

Parameter Erforderlich Beschreibung
phpVersion Ja Eine von 8.1, 8.2, 8.3, 8.4, 8.5.

Antwort

{ "data": { "id": "69e80ac1...", "subdomain": "ws-0862c.sitequest.eu", "phpVersion": "8.4" } }

Fehler

Status Code Beschreibung
400 INVALID_PHP_VERSION Version nicht unterstützt.
400 NO_CHANGES Webspace nutzt diese Version bereits.

Beispiel

curl -X PATCH https://site.quest/api/v1/webspaces/69e80ac1.../php \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "phpVersion": "8.4" }'

MCP

Diese Aktion ist auch über das webspace_set_php MCP-Tool verfügbar.

CMS installieren

CMS in den Webspace-Docroot installieren (oder neu installieren). Vorhandene Inhalte werden gelöscht. Liefert eine jobId für SSE-Fortschritt.

Erforderlicher Scope: webspace:manage

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body

Parameter Erforderlich Beschreibung
cms Ja STATIC, WORDPRESS, JOOMLA, DRUPAL oder TYPO3.

Antwort

{
  "data": {
    "id": "69e80ac1...",
    "subdomain": "ws-0862c.sitequest.eu",
    "cms": "WORDPRESS",
    "jobId": "a1b2c3d4e5f6...",
    "status": "installing"
  }
}

Antwortfelder

Feld Typ Beschreibung
jobId string Über diese ID kann der Install-Fortschritt abonniert werden.

Fehler

Status Code Beschreibung
400 INVALID_CMS cms ist kein erlaubter Wert.
409 NODE_NOT_LINKED Webspace-Node ist nicht mit einer VM verknüpft.

Beispiel

curl -X POST https://site.quest/api/v1/webspaces/69e80ac1.../cms \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "cms": "WORDPRESS" }'

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.

Datenbank-Passwort zurücksetzen

Neues MariaDB-Passwort generieren. Das Klartext-Passwort wird einmal zurückgegeben — sofort speichern.

Erforderlicher Scope: webspace:manage

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "id": "69e80ac1...",
    "subdomain": "ws-0862c.sitequest.eu",
    "dbName": "ws_0862c_db",
    "dbUser": "ws_0862c",
    "dbPassword": "Z9v…",
    "dbHost": "localhost",
    "warning": "Store this password now — it will not be shown again."
  }
}

Antwortfelder

Feld Typ Beschreibung
dbPassword string Wird nur einmal zurückgegeben. Kann später nicht abgefragt werden.
dbHost string MariaDB-Host. Immer localhost (nur aus dem Webspace erreichbar).

Beispiel

curl -X POST https://site.quest/api/v1/webspaces/69e80ac1.../db/password \
  -H "Authorization: Bearer sq_live_..."

MCP

Diese Aktion ist auch über das webspace_reset_db_password MCP-Tool verfügbar.

Verknüpfte Domains auflisten

Verknüpfte Custom-Domains eines Webspaces auflisten.

Erforderlicher Scope: webspace:read

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": [
    {
      "id": "69ee...",
      "domain": "blog.example.com",
      "domainId": "69dd...",
      "sslActive": true,
      "sslExpiry": "2027-04-22T00:00:00.000Z",
      "createdAt": "2026-04-22T12:34:56.000Z"
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
domainId string Referenz auf den Domain-Eintrag des Nutzers.

Beispiel

curl https://site.quest/api/v1/webspaces/69e80ac1.../domains \
  -H "Authorization: Bearer sq_live_..."

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.

Webspace kündigen

Kündige ein Webspace-Abo zum Ende der aktuellen Abrechnungsperiode. Der Webspace läuft bis zum Ablaufdatum weiter und wird dann mit allen Daten entfernt. Kostenlose Webspaces haben kein Abo und können nicht gekündigt werden. Nutze dafür Webspace löschen.

Erforderlicher Scope: webspace:cancel

Pfad-Parameter

Parameter Typ Beschreibung
id string Die Webspace-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer YOUR_API_KEY

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "subdomain": "my-site",
    "cancelled": true,
    "expiresAt": "2026-04-15T00:00:00.000Z"
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Die Webspace-ID
subdomain string Die Subdomain des Webspaces
cancelled boolean Nach erfolgreicher Kündigung immer true
expiresAt string ISO-8601-Datum, an dem der Webspace abläuft

Fehlerantworten

Status Beschreibung
403 API-Schlüssel hat nicht den erforderlichen webspace:cancel-Scope
404 Webspace nicht gefunden oder kein Owner-Zugriff
409 Kostenloser Webspace oder kein aktives Abo gefunden

Beispiel

curl -X POST https://site.quest/api/v1/webspaces/507f1f77bcf86cd799439011/cancel \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

Reaktivierung

Um einen gekündigten Webspace vor dem Ablaufdatum zu reaktivieren, nutze den Endpunkt Webspace reaktivieren.

MCP

Diese Aktion ist auch über das MCP-Tool webspace_cancel verfügbar.

Webspace reaktivieren

Reaktiviere ein gekündigtes Webspace-Abo vor dem Ablaufdatum. Die Kündigung wird aufgehoben und die Abrechnung läuft weiter.

Erforderlicher Scope: webspace:cancel

Pfad-Parameter

Parameter Typ Beschreibung
id string Die Webspace-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer YOUR_API_KEY

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "subdomain": "my-site",
    "reactivated": true
  }
}

Fehlerantworten

Status Beschreibung
403 API-Schlüssel hat nicht den erforderlichen webspace:cancel-Scope
404 Webspace nicht gefunden oder kein Owner-Zugriff
409 Kostenloser Webspace oder kein gekündigtes Abo gefunden

Beispiel

curl -X POST https://site.quest/api/v1/webspaces/507f1f77bcf86cd799439011/uncancel \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Aktion ist auch über das MCP-Tool webspace_uncancel verfügbar.

Webspace löschen

Kostenlosen Webspace endgültig löschen. Bestätigung erforderlich.

Bezahlte Webspaces lassen sich nicht löschen. Nutze Webspace kündigen: Der Webspace läuft bis zum Ende des bezahlten Zeitraums und wird dann entfernt. Nach dem Löschen kannst du keinen neuen kostenlosen Webspace anlegen, denn jedes Konto erhält nur einen.

Erforderlicher Scope: webspace:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Body

Parameter Erforderlich Beschreibung
confirm Ja Muss exakt true sein.

Antwort

{ "data": { "id": "69e80ac118f081032f3b0416", "subdomain": "ws-0862c.sitequest.eu", "deleted": true } }

Fehler

Status Code Beschreibung
400 MISSING_CONFIRM Body enthielt nicht { "confirm": true }.
409 PAID_WEBSPACE Der Webspace ist bezahlt und muss gekündigt werden.

Beispiel

curl -X DELETE https://site.quest/api/v1/webspaces/69e80ac118f081032f3b0416 \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "confirm": true }'

MCP

Diese Aktion ist auch über das webspace_delete MCP-Tool verfügbar.