---
title: "Rename an application"
method: PATCH
path: "/applications/{id}"
tags: ["Applications"]
---

# Rename an application

`PATCH /applications/{id}`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/applications/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string, required

## Response `200`

Application

- Application
  - `id` string, required
  - `tenant_id` string
  - `name` string, required
  - `environment` 'production' | 'staging' | 'development'
  - `default_origin` string
  - `connect_target` ConnectTarget
    - `cname_target` string, required
    - `apex_ipv4` string[]
  - `sandbox` boolean: `true` for a **test mode** application, made with `"sandbox": true` on `POST /applications`. It runs the whole connect flow end to end (the widget, the API, webhooks) against simulated DNS, on reserved `.test` names only, and never touches a real domain, the free domain, the quota or billing. Fixed when the application is created. Omitted (treated as `false`) on a live application.
  - `created_at` string, date-time

## Other responses

- `400`: Error envelope: {code, title, details}.
- `401`: Error envelope: {code, title, details}.
- `403`: Error envelope: {code, title, details}.
- `404`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)