Byline CMS
  • Home
  • Docs
  • About
Byline CMS
View on GitHub
  • Getting Started
    • Overview
    • CLI
    • Development environment and example application
    • Configuration
    • Upgrading from 3.21 to 4.x
  • Why Byline
    • Overview
    • Mission & Vision
    • Content Management in the Time of AI
  • Key Architectural Decisions
    • Overview
    • Core Document Storage
    • Core Composition
    • Transactions
    • Path Grammar
    • Deployment Topologies
  • Collections
    • Overview
    • Fields
    • Blocks
    • Relationships
    • Document Trees
    • Document Paths
    • File / Media Uploads
    • Rich Text Editor
    • Collection Versioning
  • Reading & Delivery
    • Overview
    • Search & Document Extraction
    • Client SDK (@byline/client)
    • Routing & API
    • Transports
    • Markdown Export
    • MCP Server
    • Caching
  • Search
    • Overview
    • Configure search
    • Indexing and reindexing
    • Search API
    • Search provider contract
    • Portable multilingual search analysis
    • PostgreSQL and MySQL search providers
    • Attachment extraction for search
  • Auth & Security
    • Overview
    • Authentication & Authorization
    • Auditability
  • Internationalization (i18n)
    • Overview
    • The host i18n system
    • Admin interface translations
    • Content locales
    • Administering content locales
  • Admin UI
    • Overview
    • UI Kit (@byline/ui)
    • Client-config registration
  • API Reference
    • Overview
    • Configuration API
    • Collections API
    • Fields API
    • Client SDK API
  • Testing
  • Home

API Reference

Companions:

  • Configuration — an introductory tour of the application files and runtime boundaries behind these contracts.
  • Key architectural decisions — the design context for the APIs listed here.
  • Testing — the unit, integration, and browser suites used to verify these contracts.

This section is the lookup surface for Byline's application-facing APIs. Use it when you know which system you are configuring and need the exact properties, defaults, parameters, return shapes, or runtime restrictions.

Core references

  • Configuration API documents BaseConfig, ClientConfig, ServerConfig, BylineCore, configuration registration, and server client getters.
  • Collections API documents CollectionDefinition, CollectionAdminConfig, BlockAdminConfig, workflow configuration, and lifecycle hooks.
  • Fields API documents the common field contract, all 22 built-in field kinds, default values, validation, hooks, and admin field overrides.
  • Client SDK API documents BylineClientConfig, BylineClient, every public CollectionHandle method, shared read and write options, and result envelopes.

Subsystem references

These existing documents remain the canonical references for their narrower contracts:

Surface

Canonical reference

Authentication, actors, abilities, and sessions

Authentication and authorization

Audit log and version attribution

Auditability

File and image uploads, UploadConfig, and upload hooks

File and media uploads

Relation fields, populate, and relation envelopes

Relationships

Rich-text editor and server adapters

Rich text

Document paths and slugifiers

Document paths

Document trees

Document trees

Search collection configuration

Search configuration

Search query API

Search API

SearchProvider implementation contract

Search provider contract

Admin and API route mounts

Routing and API

Interface and content locale configuration

Internationalization

Database adapter contract and boot composition

Core composition

Typed EAV storage and stored value shapes

Document storage

Reference conventions

  • A property without ? is required by TypeScript.
  • “Conditional” means the property is optional in the type but required when another configured feature uses it.
  • Defaults describe current runtime behavior when the property is omitted.
  • _-prefixed options are internal or trusted-tooling escape hatches, even when TypeScript exposes them for hook re-entry.
  • The implementation and exported TypeScript types remain authoritative when a reference and a locally installed package version differ.
PreviousClient-config registration
NextConfiguration API

On this Page

  • Core references
  • Subsystem references
  • Reference conventions
Byline CMS

Building the future of content management, one commit at a time.

Project

  • Documentation
  • Roadmap
  • Contributing
  • Releases

Community

  • GitHub Discussions
  • Blog
  • Newsletter

Legal

  • Privacy Policy
  • Terms of Use
  • Cookies

© 2026 Infonomic Company Limited and contributors. Open source and built with ❤️ by the community.