---
title: "Set or clear the application-wide default origin"
method: PUT
path: "/applications/{id}/power:default"
tags: ["Power"]
---

# Set or clear the application-wide default origin

`PUT /applications/{id}/power:default`

## Request

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

Send `default_origin: ""` to clear it. The value is validated by the same guard a per-connection origin gets, and the edge re-validates the RESOLVED address at dial time: a hostname that passes here and is later repointed at a private address is refused when the edge connects.

## Path parameters

- `id` string, required

## Request body

- object
  - `default_origin` string, required: Absolute http(s) URL, or "" to clear.

## Response `200`

The stored default

- ApplicationDefaultOrigin
  - `application_id` string
  - `default_origin` string: Absent when no default is set.
  - `configured` boolean: Whether a default is set. Distinguishes "no default" from an empty value.

## Other responses

- `400`: Error envelope: {code, title, details}.
- `401`: Error envelope: {code, title, details}.
- `402`: Error envelope: {code, title, details}.
- `404`: Error envelope: {code, title, details}.
- `503`: 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)
