> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Domain festlegen

> Binde deine Website an eine eigene Domain an. Es gilt ein Rate-Limit von 10 Änderungen alle 5 Minuten und 50 alle 24 Stunden.

**Du benötigst mindestens den [Standard-Plan](https://squarecloud.app/de/pricing), um diese Route zu nutzen.**

Dasselbe Konto kann eine Domain an mehrere Anwendungen binden (Load Balancing): bis zu 2 Anwendungen im Standard-, 5 im Pro- und 10 im Enterprise-Plan. Siehe [Load Balancer auflisten](/de/api-reference/endpoint/apps/network/load-balancers).

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren [Kontoeinstellungen](https://squarecloud.app/de/account/security).
</ParamField>

### Parameter

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.
</ParamField>

<ParamField body="custom" type="string" placeholder="example.com" required>
  Die vollständig qualifizierte Domain, die angebunden werden soll, oder `@`, um die aktuelle Custom Domain der Anwendung zu entfernen. Es darf keine Square-Cloud-Domain sein (`squareweb.app`, `squarecloud.app`, ...).
</ParamField>

### Antwort

<ResponseField name="status" type="string">
  Gibt an, ob der Aufruf erfolgreich war. `success` bei Erfolg, `error` andernfalls.
</ResponseField>

Bei einem Fehler enthält die Antwort einen Fehler-`code`:

| Status | Code                          | Bedeutung                                                                                     |
| ------ | ----------------------------- | --------------------------------------------------------------------------------------------- |
| `400`  | `REGEX_VALIDATION`            | Die Domain ist kein gültiger vollständig qualifizierter Domainname.                           |
| `400`  | `RESERVED_DOMAIN`             | Square-Cloud-Domains können nicht als Custom Domain verwendet werden.                         |
| `403`  | `UPGRADE_REQUIRED`            | Der aktive Plan beinhaltet keine Custom Domains (Standard, Pro oder Enterprise erforderlich). |
| `403`  | `LOAD_BALANCER_LIMIT_REACHED` | Das Limit des Plans für Anwendungen auf dieser Domain wurde erreicht.                         |
| `409`  | `DOMAIN_ALREADY_EXISTS`       | Die Domain ist bereits an eine Anwendung eines anderen Kontos gebunden.                       |
| `502`  | `DNS_FAILED`                  | Die Domain-Anbindung ist beim Edge-Provider fehlgeschlagen.                                   |

<ResponseExample>
  ```json theme={null}
  {
      "status": "success"
  }
  ```
</ResponseExample>