Update URL redirect

curl --request PUT \
  --url https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id} \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "source_path": "/old-pricing",
  "target_path": "/pricing",
  "match_type": "single"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}"

payload = {
    "source_path": "/old-pricing",
    "target_path": "/pricing",
    "match_type": "single"
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({source_path: '/old-pricing', target_path: '/pricing', match_type: 'single'})
};

fetch('https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'source_path' => '/old-pricing',
    'target_path' => '/pricing',
    'match_type' => 'single'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}"

	payload := strings.NewReader("{\n  \"source_path\": \"/old-pricing\",\n  \"target_path\": \"/pricing\",\n  \"match_type\": \"single\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source_path\": \"/old-pricing\",\n  \"target_path\": \"/pricing\",\n  \"match_type\": \"single\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source_path\": \"/old-pricing\",\n  \"target_path\": \"/pricing\",\n  \"match_type\": \"single\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "68c2d1e5f3b8a4216e9b5583",
  "source_path": "/old-pricing",
  "target_path": "/pricing",
  "match_type": "single"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

API Reference

Update URL redirect

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Replaces a redirect’s source, target and match type.

Send the whole rule: every field is applied, not merged, and the same rules as Create URL redirect apply. If the new rule conflicts with another one the redirect is left exactly as it was.

Send match_type every time. It defaults to single, so leaving it out of an update to a prefix rule quietly narrows the rule to its own path and every child path stops redirecting.

Changing source_path tries to drop the cached copy of both the old and the new path. As on Create URL redirect that is best effort and unreported: an old source whose cache survives can keep serving the previous target’s page, with a 200, until the cache revalidates or expires.

Both paths start with /, are at most 512 characters, and carry no query string or fragment; Base44 strips a trailing slash and decodes percent-escapes before storing them, so /old/ and /%6Fld are the same rule. target_path may instead be an absolute https:// URL to send visitors to another site.

A rule is rejected when its source is a reserved path the redirect layer never sees (/sitemap.xml, /robots.txt, /favicon.ico, /manifest.json, /link_preview.png, /llms.txt, /.well-known/*, and the app’s auth paths), when source and target are equal, when a prefix rule starts at /, and when it overlaps another rule or would make a visitor follow two redirects in a row. Overlap is resolved against the whole rule set, so a prefix rule at /docs blocks a single rule at /docs/intro, and an internal target that matches any other rule’s source is a chain.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

PUT

api

apps

{app_id}

url-redirects

{redirect_id}

Update URL redirect

curl --request PUT \
  --url https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id} \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "source_path": "/old-pricing",
  "target_path": "/pricing",
  "match_type": "single"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}"

payload = {
    "source_path": "/old-pricing",
    "target_path": "/pricing",
    "match_type": "single"
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({source_path: '/old-pricing', target_path: '/pricing', match_type: 'single'})
};

fetch('https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'source_path' => '/old-pricing',
    'target_path' => '/pricing',
    'match_type' => 'single'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}"

	payload := strings.NewReader("{\n  \"source_path\": \"/old-pricing\",\n  \"target_path\": \"/pricing\",\n  \"match_type\": \"single\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source_path\": \"/old-pricing\",\n  \"target_path\": \"/pricing\",\n  \"match_type\": \"single\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/url-redirects/{redirect_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source_path\": \"/old-pricing\",\n  \"target_path\": \"/pricing\",\n  \"match_type\": \"single\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "68c2d1e5f3b8a4216e9b5583",
  "source_path": "/old-pricing",
  "target_path": "/pricing",
  "match_type": "single"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose URL redirects to manage.

redirect_id

string

required

ID of the redirect, as returned in id by List URL redirects.

Body

application/json

source_path

string

required

Path visitors request, starting with /. Base44 strips a trailing slash and decodes percent-escapes before storing it, so /old/ and /%6Fld are the same rule.

Required string length: 1 - 512

Example:

"/old-pricing"

target_path

string

required

Where to send them: an internal path starting with /, or an absolute https:// URL on another site. Store it without a query string or fragment; the visitor's own query string is carried over to the destination, so /old?utm=x lands on /new?utm=x.

Required string length: 1 - 512

Example:

"/pricing"

match_type

enum<string>

default:single

single redirects that exact path. prefix redirects it and everything under it, keeping the remainder of the path. Defaults to single, so omitting it on an update turns an existing prefix rule into a single one and its child paths stop redirecting.

Available options:

single,

prefix

Example:

"single"

Response

The updated redirect.

One 301 redirect rule on the app's published site.

string

required

ID of the redirect. Pass it as redirect_id to Update URL redirect and Delete URL redirect.

Example:

"68c2d1e5f3b8a4216e9b5583"

source_path

string

required

The path visitors request, normalized: no trailing slash, percent-escapes decoded.

Example:

"/old-pricing"

target_path

string

required

Where the visitor is sent. Either an internal path or an absolute https:// URL on another site.

Example:

"/pricing"

match_type

enum<string>

required

single redirects that exact path. prefix redirects the path and everything under it, keeping the remainder of the path.

Available options:

single,

prefix

Example:

"single"

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Update URL redirect

Authorizations

Path Parameters

Body

Response