GET/v1/blogs/{subdomain}

Get blog metadata

Returns the public metadata for a blog: display name, description, language, logo, cover image, author profile, and ordered navigation menu. This is typically the first call a headless front-end makes to bootstrap itself. The `url` field contains the canonical base URL of the blog (custom domain when configured, or the default `{subdomain}.writizzy.com` URL otherwise). Use it to construct absolute links to posts and pages.

Parameters

Name In Type Description
subdomain*
pathstringSubdomain of the blog (e.g. `alice` for `alice.writizzy.com`). Also accepts the subdomain of a blog configured with a custom domain.

Responses

200Blog metadata retrieved successfully
namestringrequired

Blog display name

subdomainstringrequired

Writizzy subdomain (e.g. 'alice' for alice.writizzy.com)

urlstringrequired

Canonical public URL of the blog (custom domain if configured, subdomain URL otherwise)

taglinestringoptional

Short tagline displayed in the blog header

descriptionstringoptional

Longer description of the blog, suitable for SEO meta tags

languagestringrequired

BCP 47 language tag for the blog's primary content language (e.g. 'en', 'fr')

timezonestringrequired

IANA timezone identifier used for publication dates (e.g. 'Europe/Paris', 'UTC')

logoUrlstringoptional

URL of the blog logo image

coverImageUrlstringoptional

URL of the blog cover / hero image

authorobjectrequired

Public profile of the blog owner

navigationobject[]required

Ordered list of navigation menu items configured by the blog owner

labelstringrequired

Display label for the navigation link

urlstringrequired

URL the navigation item points to (relative for internal pages, absolute for external links)

Code example

GET/v1/blogs/{subdomain}
curl -X GET \
  -H "Accept: application/json" \
  "http://localhost:8080/v1/blogs/<subdomain>"
GET/v1/blogs/{subdomain}
curl -X GET \
  -H "Accept: application/json" \
  "http://localhost:8080/v1/blogs/<subdomain>"