UrlRedirects: HubSpot URL Redirects |
Get current redirectsReturns all existing URL redirects. Results can be limited and filtered by creation or updated date.
Catalog: UrlRedirects3
Schema: Redirects
Label: URL Redirects
Retrieve: true
Insert: true
Update: false
Delete: false
Parameters of Table Function
The following parameters can be used to control the behaviour of the table function UrlRedirects. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be evaluated using their default values.
Value specification by position is done by listing all values from the first to the last needed value. For example: a `select * from table(value1, value2, value3)` on a table with four parameters will use the default value for the fourth parameter and the specified values for the first three.
Value specification by name is done by listing all values that require a value. For example with `select * from table(name1 => value1, name3 => value3)` on the same table will use the default values for the second and fourth parameters and the specified values for the first and third.
Name |
Data Type |
Required |
Default Value |
Documentation |
---|---|---|---|---|
after |
string |
☐ |
|
The paging cursor token of the last successfully read resource will be returned as the `paging.next.after` JSON property of a paged response containing more results. |
archived |
boolean |
☐ |
|
Whether to return only results that have been archived. |
createdAfter |
datetime |
☐ |
|
Only return redirects created after this date. |
createdAt |
datetime |
☐ |
|
Only return redirects created on exactly this date. |
createdBefore |
datetime |
☐ |
|
Only return redirects created before this date. |
updatedAfter |
datetime |
☐ |
|
Only return redirects last updated after this date. |
updatedAt |
datetime |
☐ |
|
Only return redirects last updated on exactly this date. |
updatedBefore |
datetime |
☐ |
|
Only return redirects last updated before this date. |
Columns of Table Function
The columns of the table function UrlRedirects are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert.
Name |
Data Type |
Label |
Required |
Documentation |
---|---|---|---|---|
created |
datetime |
Created at |
☐ |
|
destination |
string |
Destination |
☐ |
The destination URL, where the target URL should be redirected if it matches the `routePrefix`. |
id |
string |
ID |
☐ |
The unique ID of this URL redirect. |
isMatchFullUrl |
boolean |
Is Match Full URL |
☐ |
Whether the `routePrefix` should match on the entire URL, including the domain. |
isMatchQueryString |
boolean |
Is Match Query String |
☐ |
Whether the `routePrefix` should match on the entire URL path, including the query string. |
isOnlyAfterNotFound |
boolean |
Is Only after not Found |
☐ |
Whether the URL redirect mapping should apply only if a live page on the URL isn't found. If False, the URL redirect mapping will take precedence over any existing page. |
isPattern |
boolean |
Is Pattern |
☐ |
Whether the `routePrefix` should match based on pattern. |
isProtocolAgnostic |
boolean |
Is Protocol Agnostic |
☐ |
Whether the `routePrefix` should match both HTTP and HTTPS protocols. |
isTrailingSlashOptional |
boolean |
is Trailing Slash Optional |
☐ |
Whether a trailing slash will be ignored. |
precedence |
int32 |
Precedence |
☐ |
Used to prioritize URL redirection. If a given URL matches more than one redirect, the one with the **lower** precedence will be used. |
redirectStyle |
int32 |
Redirect Style |
☐ |
The type of redirect to create. Options include: 301 (permanent), 302 (temporary), or 305 (proxy). Find more details [here](https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page). |
routePrefix |
string |
Route Prefix |
☐ |
The target incoming URL, path, or pattern to match for redirection. |
updated |
datetime |
Updated at |
☐ |
|
18-12-2024 20:09 Version 24.1.33-BETA+5180