---
title: "Set or remove the application's custom domain"
method: POST
path: "/v2/apps/{appId}/network/custom"
tags: ["Network"]
---

# Set or remove the application's custom domain

`POST /v2/apps/{appId}/network/custom`

Sets or removes the application's custom domain. Pass `custom: "@"` to remove the existing custom domain. Replacing an existing domain releases the previous one before attaching the new one, unless another application of the account still uses it.

Available only on Standard, Pro, and Enterprise plans. The new domain must be a fully qualified domain name and cannot be a Square Cloud domain. The same account may attach one domain to multiple applications (load balancing): up to 2 applications on Standard, 5 on Pro, and 10 on Enterprise. A domain attached to another account is rejected.

Requires the workspace Administrator role (or ownership) when called against a workspace-shared application. Rate limited to 10 changes per 5 minutes and 50 per day per user.

## Path parameters

- `appId` string, required

## Request body

- object
  - `custom` string, required — Fully qualified domain to attach, or `@` to remove.

## Response `200`

Custom domain set or removed.

- object
  - `status` 'success', required

## Other responses

- `400` — Domain failed validation, or is a Square Cloud domain.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `403` — The active plan does not include custom domains, or the plan's load-balancer limit for this domain was reached.
- `404` — The target application could not be found, or the caller is not a member of the workspace.
- `409` — The domain is already attached to an application owned by another account.
- `413` — The request body is larger than the maximum allowed size (100MB).
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — An unexpected error occurred while processing the request.
- `502` — Domain attachment failed at the edge provider.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)