Create URL redirect

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/url-redirects \
  --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"

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

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

print(response.text)

const options = {
  method: 'POST',
  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', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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"

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

	req, _ := http.NewRequest("POST", 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.post("https://app.base44.com/api/apps/{app_id}/url-redirects")
  .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")

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

request = Net::HTTP::Post.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

Create URL redirect

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

Adds a 301 redirect to the app’s published site.

Use it to keep old links working after you rename or remove a page. The rule takes effect on the published site once this call returns.

Base44 also tries to drop any cached copy of the source path so visitors get the redirect straight away, but that step is best effort and the response does not report it. When it does not land, the source URL keeps serving its cached page with a 200 instead of the new 301 until the cache revalidates or expires on its own. For a prefix rule only the cached children Base44 already tracks are dropped; the rest fall through the same way.

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.

An app can hold up to 50 rules; the 51st is rejected with a 400.

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.

POST

api

apps

{app_id}

url-redirects

Create URL redirect

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/url-redirects \
  --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"

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

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

print(response.text)

const options = {
  method: 'POST',
  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', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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"

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

	req, _ := http.NewRequest("POST", 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.post("https://app.base44.com/api/apps/{app_id}/url-redirects")
  .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")

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

request = Net::HTTP::Post.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.

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 redirect that was created.

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

Create URL redirect

Authorizations

Path Parameters

Body

Response