ADR-0002: Deliver API Only — No Content Management API Integration

Status

Accepted

Context

Contentful exposes two main API families:

1. Content Delivery API (CDA) — read-only, optimized for high-throughput content fetching from the CDN
2. Content Management API (CMA) — read/write, for managing content types, entries, and assets

This bundle was initially built to integrate Contentful into Symfony-based frontend applications (CMS-driven websites, SPAs with SSR). Those use cases are exclusively read operations against the CDA.

A parallel contentful/contentful-management.php SDK exists for CMA operations.

Decision

ContentfulBundle wraps only contentful/contentful (the CDA SDK) and optionally enables the Preview API (a read-only API for draft content, accessed via a separate token). No CMA integration is in scope for this bundle.

Consequences

• Bundle dependency surface is minimal: just the CDA SDK + Symfony framework bundle
• Applications needing CMA operations must wire the management SDK separately
• The scope boundary is clear — this bundle is safe to install in production applications without concern about accidental write operations
• If CMA Symfony integration is ever needed, it should be a separate bundle (contentful/management-bundle pattern) rather than expanding this bundle's scope