Sites

Get a site

Reads a site and its settings: access, languages, sync, translation, AI features, contact form and changelog.

GET
/sites/{site_id}
cURL
curl --request GET \
  --url 'https://api.notiondesk.so/sites/{site_id}' \
  --header 'Authorization: Bearer <token>'

Ủy quyền

  • Authorizationstringheader

    api_key · http · bearer

    read
  • Authorizationstringheader

    oauth · oauth2

    read

Tham số đường dẫn

  • site_idstringbắt buộc

    The id of a site from List sites.

Tiêu đề

  • nd-versionstring

    The contract version your integration was written against. Without it, the request uses the current version. An unknown value answers 400 invalid_version.

Phản hồi

The site.

Tiêu đề

  • nd-versionstring

    The contract version that answered the request.

  • X-RateLimit-Limitinteger

    Requests allowed per minute: 120 for GET, 20 for writes, per key or OAuth grant.

  • X-RateLimit-Remaininginteger

    Requests left in the current window.

  • Retry-Afterinteger

    Seconds until the next request is accepted; 0 while requests remain.

  • idstringbắt buộc

    The site identifier.

  • full_domainstring | nullbắt buộc

    The domain readers visit: the custom domain when one is active, otherwise the Notiondesk subdomain.

  • enabledbooleanbắt buộc

    Whether the site is enabled.

  • default_localestringbắt buộc

    The site's default language, for example en.

  • access_modestring | nullbắt buộc

    Who can read the site.

  • guest_access_requires_loginbooleanbắt buộc

    Whether guest-account sites ask readers to sign in.

  • supported_localesstring[]bắt buộc

    The languages the site serves, default first, limited to your plan's language allowance.

  • available_localesstring[]bắt buộc

    Every language a site can be configured to serve.

  • auto_sync_enabledbooleanbắt buộc

    Whether the site syncs from its source on a schedule.

  • seo_indexing_enabledbooleanbắt buộc

    Whether search engines may index the site.

  • setting_content_itemsobject[]bắt buộc

    The page title and description per enabled language.

    • localestringbắt buộc
    • page_titlestring | nullbắt buộc
    • page_descriptionstring | nullbắt buộc
  • auto_translate_enabledbooleanbắt buộc

    Whether missing translations are produced automatically.

  • auto_translate_source_localestring | nullbắt buộc

    The language automatic translation reads from.

  • llms_txt_enabledbooleanbắt buộc

    Whether the site publishes llms.txt.

  • markdown_export_enabledbooleanbắt buộc

    Whether articles can be read as markdown.

  • ai_contextual_menu_enabledbooleanbắt buộc

    Whether articles show the AI contextual menu.

  • mcp_search_enabledbooleanbắt buộc

    Whether the site's public MCP search is on.

  • contact_form_enabledbooleanbắt buộc

    Whether the site shows its contact form. While the workspace has the Service Desk Inbox enabled, every site shows it whatever this value holds.

  • changelog_enabledbooleanbắt buộc

    Whether the changelog is published.

  • changelog_email_subscriptions_enabledbooleanbắt buộc

    Whether readers can subscribe to changelog emails.

  • changelog_reactions_enabledbooleanbắt buộc

    Whether readers can react to changelog entries.

  • changelog_email_subject_patternstring | nullbắt buộc

    The subject line pattern of changelog emails.

  • changelog_categoriesobject[]bắt buộc

    The changelog categories.

    • category_idstringbắt buộc
    • colorstring | nullbắt buộc