Domain Forwarding2026.8.0

Update domain forwarding configuration

Creates or updates the URL forwarding configuration for a domain.

PUT/api/v1/spaces/assets/domains/{domain}/forwarding

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

domainstringRequired: Domain name in FQDN format

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

target_urlstring (uri)Required: The destination URL to redirect to
redirect_typeintegerRequired: HTTP redirect status code Allowed values: 301, 302.
preserve_pathbooleanOptional: Whether to append the original path to the target URL
preserve_query_stringbooleanOptional: Whether to preserve query parameters in the redirect

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request PUT 'https://dashio.net/api/v1/spaces/assets/domains/{domain}/forwarding' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "target_url": "<target_url>",
  "redirect_type": 301
}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Schema-generated example; not a captured response.

{
  "forwarding": {
    "id": "<id>",
    "target_url": "<target_url>",
    "redirect_type": 301,
    "path_pattern": "<path_pattern>",
    "preserve_path": false,
    "preserve_query_string": false,
    "is_active": false
  }
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

Forwarding configuration updated successfully

forwardingobjectOptional

No field description supplied.

idstring (uuid)Optional: No field description supplied.
target_urlstring (uri)Optional: No field description supplied.
redirect_typeintegerOptional: Allowed values: 301, 302.
path_patternstringOptional: No field description supplied.
preserve_pathbooleanOptional: No field description supplied.
preserve_query_stringbooleanOptional: No field description supplied.
is_activebooleanOptional: No field description supplied.

400

Invalid request body

No response body schema supplied.

401

Unauthenticated

No response body schema supplied.

404

Domain not found

No response body schema supplied.

Was this helpful?

Update domain forwarding configuration

Authentication

Path parameters

Query parameters

Header parameters

Cookie parameters

Request body

Responses

200

7 child fields

400

401

404