Open API v2 / CMS & Content / Url Rewrite

Url Rewrite

→

Every request needs a bearer token: Authorization: Bearer <token>. Base URL https://your-site.webinone.com. New to field types? See the type reference.

GET/api/v2/admin/url-rewrites#

Retrieves a list of url rewrites by using a "where" filtering

Parameters

Wherestring · query

JSON filter expression. Combine operators ($eq, $contains, $gt, $in, …) with $and / $or.

Order_Bystring · query

Sort field. Prefix with - for descending; comma-separate for tie-breakers.

Semantic_Querystring · query

Natural-language search, ranked by relevance.

Min_Scorenumber · query

Lowest relevance score to include when using Semantic_Query.

Offsetinteger · query

Number of items to skip before returning results. Defaults to 0.

Limitinteger · query

Maximum number of items to return. Defaults to 100.

Response

Idstring · nullable

Unique identifier. Technical record number in the database. Read-only.

RewrittenUrlstring

"Mask" or visible address. What the user sees in the browser or types into the search bar (for example, /contacts).

RewriteTostring

The actual technical path to the file or handler on the server that should execute the request (for example, /pages/static.aspx?id=12).

Enabledboolean

Rule status. True — the rule is active and requests are being processed, false — the server ignores this rule.

curl "https://your-site.webinone.com/api/v2/admin/url-rewrites" \
  -H "Authorization: Bearer <token>"

await fetch("https://your-site.webinone.com/api/v2/admin/url-rewrites", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

import requests

requests.get(
    "https://your-site.webinone.com/api/v2/admin/url-rewrites",
    headers={"Authorization": "Bearer <token>"}
)

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://your-site.webinone.com/api/v2/admin/url-rewrites', [
    'headers' => [
        'Authorization' => 'Bearer <token>'
    ]
]);

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://your-site.webinone.com/api/v2/admin/url-rewrites");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);

Response · 200

{
  "Items": [
    {
      "Id": "string",
      "RewrittenUrl": "https://example.com",
      "RewriteTo": "string",
      "Enabled": false
    }
  ],
  "TotalItemsCount": 0
}

POST/api/v2/admin/url-rewrites#

Creates a new url rewrite

Body parameters

RewrittenUrlstringrequired

"Mask" or visible address. What the user sees in the browser or types into the search bar (for example, /contacts).

RewriteTostringrequired

The actual technical path to the file or handler on the server that should execute the request (for example, /pages/static.aspx?id=12).

Enabledboolean

Rule status. True — the rule is active and requests are being processed, false — the server ignores this rule.

Response

Idstring · nullable

Unique identifier. Technical record number in the database. Read-only.

RewrittenUrlstring

"Mask" or visible address. What the user sees in the browser or types into the search bar (for example, /contacts).

RewriteTostring

The actual technical path to the file or handler on the server that should execute the request (for example, /pages/static.aspx?id=12).

Enabledboolean

Rule status. True — the rule is active and requests are being processed, false — the server ignores this rule.

curl -X POST "https://your-site.webinone.com/api/v2/admin/url-rewrites" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"RewrittenUrl":"https://example.com","RewriteTo":"string","Enabled":false}'

await fetch("https://your-site.webinone.com/api/v2/admin/url-rewrites", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "RewrittenUrl": "https://example.com",
    "RewriteTo": "string",
    "Enabled": false
  })
});

import requests

requests.post(
    "https://your-site.webinone.com/api/v2/admin/url-rewrites",
    headers={"Authorization": "Bearer <token>"},
    json={
        "RewrittenUrl": "https://example.com",
        "RewriteTo": "string",
        "Enabled": False
    }
)

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://your-site.webinone.com/api/v2/admin/url-rewrites', [
    'headers' => [
        'Authorization' => 'Bearer <token>',
        'Content-Type' => 'application/json'
    ],
    'json' => [
        'RewrittenUrl' => 'https://example.com',
        'RewriteTo' => 'string',
        'Enabled' => false
    ]
]);

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://your-site.webinone.com/api/v2/admin/url-rewrites");
request.Headers.Add("Authorization", "Bearer <token>");
request.Content = new StringContent(
    "{\"RewrittenUrl\":\"https://example.com\",\"RewriteTo\":\"string\",\"Enabled\":false}",
    Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);

Response · 200

{
  "Id": "string",
  "RewrittenUrl": "https://example.com",
  "RewriteTo": "string",
  "Enabled": false
}

GET/api/v2/admin/url-rewrites/{id}#

Retrieves a single url rewrite

Parameters

idinteger · pathrequired

Url rewrite id.

Response

Idstring · nullable

Unique identifier. Technical record number in the database. Read-only.

RewrittenUrlstring

"Mask" or visible address. What the user sees in the browser or types into the search bar (for example, /contacts).

RewriteTostring

The actual technical path to the file or handler on the server that should execute the request (for example, /pages/static.aspx?id=12).

Enabledboolean

Rule status. True — the rule is active and requests are being processed, false — the server ignores this rule.

curl "https://your-site.webinone.com/api/v2/admin/url-rewrites/1" \
  -H "Authorization: Bearer <token>"

await fetch("https://your-site.webinone.com/api/v2/admin/url-rewrites/1", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

import requests

requests.get(
    "https://your-site.webinone.com/api/v2/admin/url-rewrites/1",
    headers={"Authorization": "Bearer <token>"}
)

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://your-site.webinone.com/api/v2/admin/url-rewrites/1', [
    'headers' => [
        'Authorization' => 'Bearer <token>'
    ]
]);

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://your-site.webinone.com/api/v2/admin/url-rewrites/1");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);

Response · 200

{
  "Id": "string",
  "RewrittenUrl": "https://example.com",
  "RewriteTo": "string",
  "Enabled": false
}

PUT/api/v2/admin/url-rewrites/{id}#

Updates an existing url rewrite

Parameters

idinteger · pathrequired

Existent url rewrite id.

Body parameters

RewrittenUrlstringrequired

"Mask" or visible address. What the user sees in the browser or types into the search bar (for example, /contacts).

RewriteTostringrequired

The actual technical path to the file or handler on the server that should execute the request (for example, /pages/static.aspx?id=12).

Enabledboolean

Rule status. True — the rule is active and requests are being processed, false — the server ignores this rule.

Response

Idstring · nullable

Unique identifier. Technical record number in the database. Read-only.

RewrittenUrlstring

"Mask" or visible address. What the user sees in the browser or types into the search bar (for example, /contacts).

RewriteTostring

The actual technical path to the file or handler on the server that should execute the request (for example, /pages/static.aspx?id=12).

Enabledboolean

Rule status. True — the rule is active and requests are being processed, false — the server ignores this rule.

curl -X PUT "https://your-site.webinone.com/api/v2/admin/url-rewrites/1" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"RewrittenUrl":"https://example.com","RewriteTo":"string","Enabled":false}'

await fetch("https://your-site.webinone.com/api/v2/admin/url-rewrites/1", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "RewrittenUrl": "https://example.com",
    "RewriteTo": "string",
    "Enabled": false
  })
});

import requests

requests.put(
    "https://your-site.webinone.com/api/v2/admin/url-rewrites/1",
    headers={"Authorization": "Bearer <token>"},
    json={
        "RewrittenUrl": "https://example.com",
        "RewriteTo": "string",
        "Enabled": False
    }
)

$client = new GuzzleHttp\Client();
$response = $client->request('PUT', 'https://your-site.webinone.com/api/v2/admin/url-rewrites/1', [
    'headers' => [
        'Authorization' => 'Bearer <token>',
        'Content-Type' => 'application/json'
    ],
    'json' => [
        'RewrittenUrl' => 'https://example.com',
        'RewriteTo' => 'string',
        'Enabled' => false
    ]
]);

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://your-site.webinone.com/api/v2/admin/url-rewrites/1");
request.Headers.Add("Authorization", "Bearer <token>");
request.Content = new StringContent(
    "{\"RewrittenUrl\":\"https://example.com\",\"RewriteTo\":\"string\",\"Enabled\":false}",
    Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);

Response · 200

{
  "Id": "string",
  "RewrittenUrl": "https://example.com",
  "RewriteTo": "string",
  "Enabled": false
}

DELETE/api/v2/admin/url-rewrites/{id}#

Deletes an existing url rewrite

Parameters

idinteger · pathrequired

Existent url rewrite id.

curl -X DELETE "https://your-site.webinone.com/api/v2/admin/url-rewrites/1" \
  -H "Authorization: Bearer <token>"

await fetch("https://your-site.webinone.com/api/v2/admin/url-rewrites/1", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

import requests

requests.delete(
    "https://your-site.webinone.com/api/v2/admin/url-rewrites/1",
    headers={"Authorization": "Bearer <token>"}
)

$client = new GuzzleHttp\Client();
$response = $client->request('DELETE', 'https://your-site.webinone.com/api/v2/admin/url-rewrites/1', [
    'headers' => [
        'Authorization' => 'Bearer <token>'
    ]
]);

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Delete, "https://your-site.webinone.com/api/v2/admin/url-rewrites/1");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);