---
title: "Forward a domain to a URL"
method: PUT
path: "/api/domains/{domain}/redirect"
tags: ["Domains"]
---

# Forward a domain to a URL

`PUT /api/domains/{domain}/redirect`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/domains/{domain}/redirect`
- Auth: HTTP bearer

Forward a domain you own to another URL (e.g. brand.com -> https://brand.dev) - useful for multi-TLD brands. The domain must point at domani's nameservers/parking IP for the redirect to serve. Permanent (308) by default or temporary (307). Requires `domains:write` scope.

## Path parameters

- `domain` string, required

## Request body

- object
  - `url` string, required: Target URL (or bare domain) to forward to, e.g. https://brand.dev
  - `permanent` boolean: true = permanent (308, default), false = temporary (307)

## Response `200`

Redirect set

- object
  - `domain` string
  - `redirect_url` string, nullable
  - `permanent` boolean

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key
- `404`: Domain not found
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)