Ir al contenido principal
Help Centers

Get a redirect rule by URL

Retrieves a specific redirect rule by its source URL.

GET
/v2/help_center/redirect_rules/by-url

The url query parameter is normalized before matching: query parameters and hash fragments are stripped, the hostname is lowercased, and trailing slashes are removed. This is the same normalization applied when creating a redirect rule.

Query Parameters

  • url (required) - Full absolute URL to look up (http or https)

Response

Returns a redirect rule object with:

  • id - Unique identifier (MongoDB ObjectId)
  • helpCenterId - Help center this rule belongs to
  • locale - Locale code
  • fromUrl - Canonical source URL being redirected from
  • targetType - "article" or "collection"
  • targetId - ID of the target article or collection
  • createdAt - ISO 8601 timestamp when created
  • updatedAt - ISO 8601 timestamp when last updated

Errors

  • 400 - Invalid URL format
  • 404 - No redirect rule exists for the given URL

Autorizaciones

Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

Parámetros de consulta

urlstringqueryobligatorio

Full absolute URL to look up. The URL is normalized before matching: query parameters and hash fragments are stripped, the hostname is lowercased, and trailing slashes are removed.

Maximum string length: 2048
Ejemplo: https://help.example.com/en/old/getting-started

Encabezados

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Ejemplo: 2026-08-19.orbit

Respuesta

application/json

Success

createdAtstringobligatorio

ISO 8601 timestamp when created

Ejemplo: 2026-02-11T12:00:00.000Z
fromUrlstringobligatorio

Canonical source URL being redirected from (query and hash stripped)

Ejemplo: https://help.example.com/en/old/getting-started
helpCenterIdstringobligatorio

Help center identifier

Ejemplo: ox6qrqprmsuqaunj
idstringobligatorio

Redirect rule unique identifier

Ejemplo: 507f1f77bcf86cd799439011
localeenum<string>obligatorio

Locale code for the redirect rule

Opciones disponibles: ar, am, fa, ht, lo, my, pa, ps, so, tl, ur, he, ta, te, mr, gu, kn, ml, ha, jv, yo, ig, uz, ne, sd, az, si, km, kk, bn, bs, pt-BR, bg, ca, hr, cs, da, nl, en, et, fi, fr, de, el, hi, hu, id, it, ja, ko, lv, lt, ms, mn, nb, pl, pt, ro, ru, sr, zh-CN, sk, sl, es, sw, sv, th, zh-TW, tr, uk, vi
Ejemplo: en
objectenum<string>obligatorio

Object type identifier

Opciones disponibles: redirect_rule
Ejemplo: redirect_rule
targetIdstringobligatorio

Target article or collection ID

Ejemplo: 1234567
targetTypeenum<string>obligatorio

Type of content the redirect points to

Opciones disponibles: article, collection
Ejemplo: article
updatedAtstringobligatorio

ISO 8601 timestamp when last updated

Ejemplo: 2026-02-11T12:00:00.000Z

¿Aún necesitas ayuda? Pregunta al equipo