---
title: "Turn on the default subdomain"
method: POST
path: "/v1/projects/{projectID}/default-subdomain/enable"
tags: ["Settings"]
---

# Turn on the default subdomain

`POST /v1/projects/{projectID}/default-subdomain/enable`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v1/projects/{projectID}/default-subdomain/enable`
- Auth: HTTP bearer

Makes the app reachable at `<app-name>.liara.run`. Team permission: `operate` or `manage`.

The default subdomain expires one week after the app's first successful deployment. It's then turned off, `defaultSubdomainExpired` becomes `true`, and it can't be turned back on. Connect a custom domain to keep the app reachable.

## Path parameters

- `projectID` string, required: 24-character hexadecimal ID.

## Query parameters

- `teamID` string: 24-character hexadecimal ID.

## Response `200`

Done. The response body is empty.

## Other responses

- `400`: `teamID` is invalid, or the default subdomain has expired.
- `401`: The API token is missing, invalid or expired.
- `403`: With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this app (`no_permission`).
- `404`: The app doesn't exist.

## Changes

- **2026-11-02** `610162e8a623`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liara-cloud/apis/paas/changes/v1/projects/:projectID/default-subdomain/enable/post.md)

---

[API](https://skmtc.dev/liara-cloud/apis/paas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/paas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/paas/revisions/610162e8a623?raw)