Table of Contents
Adapto CMS Public API Documentation
Complete developer reference for the Adapto CMS Public API. All endpoints are read-only and require an API key for authentication.
Base URL: https://public-api.adaptocms.com
Getting Started
Page | Description |
|---|---|
Overview of Adapto CMS, the Public API, quick start guide, and available resources. | |
How to obtain and use your API key, security best practices, and authentication errors. | |
Common query parameters for pagination, sorting, filtering, and preview endpoints. |
Client Development
Page | Description |
|---|---|
SDK methods, type definitions, caching, retries, CDN rewriting, and media hydration. | |
Integrating all content types into a Next.js 16 App Router project. | |
Integrating all content types into a SvelteKit 2 + Svelte 5 project. | |
Integrating all content types into a fully static Astro project using Content Collections. |
API Reference
Page | Endpoints | Description |
|---|---|---|
5 endpoints | List, get by ID/slug, previews, and translations for blog posts and long-form content. | |
6 endpoints | List, get by ID/slug, subcategories, articles in category, and translations. | |
4 endpoints | List, get by ID/slug, previews for static pages with hierarchical structure. | |
7 endpoints | List collections, get by ID/slug, list/get items by ID/slug, item previews. | |
6 endpoints | List, get by ID/key/language, count, and translations for UI text snippets. | |
1 endpoint | Full-text search across articles, pages, and collection items. | |
1 endpoint | List all languages with published content. |
Reference
Page | Description |
|---|---|
Complete reference for all response models, field types, and schema definitions. | |
HTTP status codes, validation errors, rate limiting, and error handling best practices. | |
The adapto CLI, environment variable authentication, llm-info for AI agent context, and common workflows. | |
Configuring webhooks, delivery payload format, and HMAC signature verification. | |
Triggering GitHub Actions workflow_dispatch events from the backoffice. | |
Migrating articles, pages, collections, and media from other CMS platforms using the CLI and an AI agent. | |
Creating and restoring project backups from the backoffice. |
All Public Endpoints at a Glance
Method | Endpoint | Description |
|---|---|---|
|
| List articles |
|
| List article previews |
|
| Get article by ID |
|
| Get article by slug |
|
| Get article translations |
|
| List categories |
|
| Get category by ID |
|
| Get category by slug |
|
| Get subcategories |
|
| Get articles in category |
|
| Get category translations |
|
| List pages |
|
| List page previews |
|
| Get page by ID |
|
| Get page by slug |
|
| List collections |
|
| Get collection by ID |
|
| Get collection by slug |
|
| List collection items |
|
| List item previews |
|
| Get item by ID |
|
| Get item by slug |
|
| List micro copy |
|
| Get micro copy by ID |
|
| Get micro copy by key |
|
| Get micro copy by language |
|
| Count micro copy entries |
|
| Get micro copy translations |
|
| Full-text search |
|
| Get available languages |