---
title: "Re-point a setup session's brokered DNS at a new ingress target"
method: POST
path: "/onprem/v1/setup-sessions/{setup_id}/dns"
tags: ["onprem", "onprem", "__public__"]
---

# Re-point a setup session's brokered DNS at a new ingress target

`POST /onprem/v1/setup-sessions/{setup_id}/dns`

## Path parameters

- `setup_id` string, required

## Request body

- SetupSessionRepointRequest — Re-point an existing setup session's brokered DNS at a new ingress target. Proof-of-possession is the license key issued to the session (the installer still holds it), so no live setup token is required after the session was created and its token consumed.
  - `ingress_target` string, required — New ingress hostname or IP address the Definite-hosted DNS record should target
  - `license_key` string, password, required — License key issued to this setup session

## Response `200`

Success

- SuccessResponseSetupSessionResponse
  - `success` true, required — Flag for it request was successful
  - `data` SetupSessionResponse, required
    - `setup_id` string, required
    - `fqdn` string, required
    - `url` string, required
    - `ingress_target` string, nullable — Ingress hostname or IP the brokered DNS record currently targets. Lets an installer detect when the live ingress LoadBalancer has changed and re-point DNS.
    - `dns_status` 'created' | 'pending' | 'ready' | 'failed', required
    - `license_key` string, nullable — Raw license key. Returned only by the create endpoint and never by status polling.
    - `license_id` union
      - string, uuid
      - string
    - `expires_at` string, date-time, required
    - `status` 'license_pending' | 'dns_pending' | 'ready' | 'failed', required
    - `error` string, nullable
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `400` — Validation Bad Request
- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `404` — Resource Not Found
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)