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 publicCollectionHandlemethod, 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 | |
Audit log and version attribution | |
File and image uploads, | |
Relation fields, populate, and relation envelopes | |
Rich-text editor and server adapters | |
Document paths and slugifiers | |
Document trees | |
Search collection configuration | |
Search query API | |
| |
Admin and API route mounts | |
Interface and content locale configuration | |
Database adapter contract and boot composition | |
Typed EAV storage and stored value shapes |
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.