Skip to content

Resolve a path

GET
/content/delivery/v1/path/{path}
curl --request GET \
--url https://api.ebitex.io/content/delivery/v1/path/example \
--header 'Authorization: Bearer <token>'

Returns whatever is published at a path. kind says what you got:

  • presentation: a page, with its Template, settings and bound component, plus the page’s title and titleSource.
  • redirect: follow targetPath yourself. Chains are collapsed server-side, and a renamed page’s old path answers with a redirect to the new one.

Name the site with site (a root node id from /sites) or host (the hostname you serve the page under). On a site with locale addressing the locale comes from the address, so locale= is refused. resolve sets how many levels of references are expanded into content, and ctx carries the visitor context used for personalization.

With an X-Ebitex-Preview-Session header, the page being previewed answers with its draft and X-Ebitex-Preview: draft; every other path answers what is published.

Key: a delivery key (content.delivery.read).

path
required
string
site
string format: uuid
host
string
locale
string
resolve
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
raw
boolean
ctx
string
include
Array<string>

OK

locale_not_addressable: the site takes its locale from the address. validation_failed: an unsupported parameter value. preview_raw_unsupported: raw=true with a preview session.

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired.

preview_site_mismatch: the path is in a different site from the page being previewed.

scope_denied: the key lacks this route’s scope. origin_denied or ip_denied: a browser-safe key was used from an origin or address outside its restrictions. app_not_available: Content is not enabled for the organization.

path_not_found: nothing is published at this path. site_not_found: no site matches site or host.

Quota exceeded; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.