SDK Types: Configuration

analytics

AnalyticsService

No

Analytics service (browser-only)

availableLocales

string[]

No

Available locales from site configuration

blocks

BlocksService

No

Alias for blocks (v3 naming)

branding

BrandingService

No

Branding service (badge for free plan)

categories

CategoriesService

No

Content categories service.<br>Provides list(), tree(), getBySlug() for fetching categories<br>with content counts and hierarchical tree structures.

config

Readonly<{ baseUrl: string; debug: boolean; siteId: string }>

No

Client configuration (readonly)

consent

ConsentService

No

Consent service (cookie consent management)

contents

ContentsService

No

Blog contents (articles) service.<br>Provides list(), getBySlug() for fetching published articles<br>with support for filtering by category, tag, search, and pagination.

cookies

CookiesService

No

Cookie consent service.<br>Provides getConfig() for banner configuration, categories, and third-party<br>scripts, and logConsent() to record the user's consent preferences<br>for GDPR compliance.

enhancements

EnhancementsService

No

Content enhancements service (code copy, etc.)

forms

FormsService

No

Forms service.<br>Provides getBySlug() for fetching form schemas and submit() for<br>sending form submissions. Supports honeypot and reCAPTCHA spam protection.

globals

BlocksService

No

Global blocks service (v3 naming)

legal

LegalService

No

Legal documents service.<br>Provides list() and getBySlug() for fetching legal pages<br>(privacy policy, terms of service, etc.).<br>Legal documents are pages tagged with 'legal'.

locale

string

No

Current locale

media

MediaHelperService

No

Image transformation helpers.<br>Use these to build optimized image URLs for responsive images.

pages

PagesService

No

Pages (site blocks) service.<br>Provides list(), getBySlug() for fetching standalone pages<br>with schema-driven data and DataSource resolution.<br>Pages are different from contents -- they represent structural site pages<br>(e.g. homepage, about, contact) rather than blog articles.

paths

PathsService

No

Paths service for static site generation (SSG/ISR).<br>Provides list() for discovering all renderable paths (contents + categories),<br>resolve() for matching a URL path to its content or category,<br>and getRedirects() for fetching all redirect rules.

reviews

ReviewsService

No

Customer reviews service.<br>Provides list() for fetching approved reviews, submit() for posting<br>new reviews, and getSettings() for the site's review configuration.<br>Only publicly approved reviews are returned.

seo

SeoService

No

SEO files service.<br>Provides getRobotsTxt() for the robots.txt content and getSitemap()<br>for the XML sitemap. Used for server-side rendering of SEO routes.

site

SiteService

No

Site configuration service.<br>Provides getConfig() for fetching site metadata, active locale,<br>and all global blocks in a single request. Also provides getI18nConfig()<br>for language switching UI data and getFullConfig() for complete site info.

tags

TagsService

No

Content tags service.<br>Provides list() for fetching all tags.<br>Tags are used to filter contents and group articles across categories.

baseUrl

string

Yes

Base URL of the Lynkow API.<br>Must not include a trailing slash.<br>Override this for self-hosted deployments or local development.

debug

boolean

Yes

Enable debug logging

fetchOptions

RequestInit

Yes

Default fetch() options merged into every request made by this client.<br>Commonly used for Next.js caching directives or custom headers.<br>Per-request fetchOptions are shallow-merged on top of these defaults.

locale

string

Yes

Default locale code for all requests made by this client.<br>Must be a locale enabled on the site (e.g. 'en', 'fr', 'de').<br>Can be overridden per-request via BaseRequestOptions.locale.<br>When omitted, the site's default locale is used for all requests.

siteId

string

No

UUID of the Lynkow site to connect to.<br>Found in the admin dashboard under Site Settings.<br>Must be a valid UUID v4 format (lowercase hex with dashes).<br>Sent as the X-Site-Id header on every API request.

blocks

BlocksService

No

Global blocks service.<br>Provides getBySlug() for fetching reusable site-wide data blocks<br>(e.g. header navigation, footer links, banners).<br>Global blocks are resolved from DataSources server-side.<br>Typically fetched once via site.getConfig() which returns all globals.

categories

CategoriesService

No

Content categories service.<br>Provides list(), tree(), getBySlug() for fetching categories<br>with content counts and hierarchical tree structures.

contents

ContentsService

No

Blog contents (articles) service.<br>Provides list(), getBySlug() for fetching published articles<br>with support for filtering by category, tag, search, and pagination.

cookies

CookiesService

No

Cookie consent service.<br>Provides getConfig() for banner configuration, categories, and third-party<br>scripts, and logConsent() to record the user's consent preferences<br>for GDPR compliance.

forms

FormsService

No

Forms service.<br>Provides getBySlug() for fetching form schemas and submit() for<br>sending form submissions. Supports honeypot and reCAPTCHA spam protection.

legal

LegalService

No

Legal documents service.<br>Provides list() and getBySlug() for fetching legal pages<br>(privacy policy, terms of service, etc.).<br>Legal documents are pages tagged with 'legal'.

pages

PagesService

No

Pages (site blocks) service.<br>Provides list(), getBySlug() for fetching standalone pages<br>with schema-driven data and DataSource resolution.<br>Pages are different from contents -- they represent structural site pages<br>(e.g. homepage, about, contact) rather than blog articles.

paths

PathsService

No

Paths service for static site generation (SSG/ISR).<br>Provides list() for discovering all renderable paths (contents + categories),<br>resolve() for matching a URL path to its content or category,<br>and getRedirects() for fetching all redirect rules.

reviews

ReviewsService

No

Customer reviews service.<br>Provides list() for fetching approved reviews, submit() for posting<br>new reviews, and getSettings() for the site's review configuration.<br>Only publicly approved reviews are returned.

seo

SeoService

No

SEO files service.<br>Provides getRobotsTxt() for the robots.txt content and getSitemap()<br>for the XML sitemap. Used for server-side rendering of SEO routes.

site

SiteService

No

Site configuration service.<br>Provides getConfig() for fetching site metadata, active locale,<br>and all global blocks in a single request. Also provides getI18nConfig()<br>for language switching UI data and getFullConfig() for complete site info.

tags

TagsService

No

Content tags service.<br>Provides list() for fetching all tags.<br>Tags are used to filter contents and group articles across categories.

baseUrl

string

Yes

Base URL of the Lynkow API.<br>Must not include a trailing slash.<br>Override this for self-hosted deployments or local development.

fetchOptions

RequestInit

Yes

Default fetch() options merged into every request made by this client.<br>Commonly used for Next.js caching directives or custom headers.<br>Per-request fetchOptions are shallow-merged on top of these defaults.

locale

string

Yes

Default locale code for all requests made by this client.<br>Must be a locale enabled on the site (e.g. 'en', 'fr', 'de').<br>Can be overridden per-request via BaseRequestOptions.locale.<br>When omitted, the site's default locale is used for all requests.

siteId

string

No

UUID of the Lynkow site to connect to.<br>Found in the admin dashboard under Site Settings.<br>Must be a valid UUID v4 format (lowercase hex with dashes).<br>Sent as the X-Site-Id header on every API request.

analytics

{ consentMode: "opt-in" | "opt-out" | "disabled" }

No

Analytics consent configuration for the site.

defaultLocale

string

No

Default locale code for the site (e.g. 'en', 'fr').<br>Content and API responses default to this locale when no locale is specified.<br>Always appears in enabledLocales.

description

string | null

No

Short site description for SEO and metadata.<br>null when no description has been set by the admin.

domain

string

No

Primary domain without protocol (e.g. 'example.com', 'blog.example.com').<br>This is the canonical domain for building absolute URLs.

enabledLocales

string[]

No

Array of all enabled locale codes (e.g. ['en', 'fr', 'de']).<br>Always contains at least defaultLocale.<br>Use this to validate locale parameters or build locale-prefixed URLs.

faviconUrl

string | null

No

Full CDN URL to the site favicon.<br>null when no favicon has been uploaded.<br>Should be used in the <link rel="icon"> tag.

i18n

I18nConfig

No

Full i18n configuration including locale display metadata,<br>language switcher settings, and automatic detection behavior.<br>See I18nConfig for details.

id

string

No

Site UUID. Same value as the siteId used to initialize the client.<br>Format: UUID v4 (e.g. '550e8400-e29b-41d4-a716-446655440000').

logoUrl

string | null

No

Full CDN URL to the site logo image.<br>null when no logo has been uploaded.<br>Typically used in the site header and Open Graph metadata.

name

string

No

Site display name, as configured by the admin.<br>Used for site branding, document titles, etc.

showBranding

boolean

No

Whether the Lynkow branding badge should be displayed on the site.<br>true on free plans; false on paid plans where branding is removed.

timezone

string | null

No

IANA timezone identifier for the site (e.g. 'Europe/Paris', 'America/New_York').<br>Used for displaying dates in the site's local time.<br>null when no timezone has been configured (defaults to UTC).