From 22b1a684974dd8210b6e828ff2b222b2457f02c8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:49:56 +0000 Subject: [PATCH 01/37] Update guides/introduction.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/introduction.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/introduction.mdx b/guides/introduction.mdx index 08d7dc4..e69bf86 100644 --- a/guides/introduction.mdx +++ b/guides/introduction.mdx @@ -1,6 +1,6 @@ --- -title: Introduction -description: "Welcome to Marble" +title: Introduction to Marble CMS +description: Marble is a simple, headless CMS built for writers and developers. Manage and publish content with a clean editor, flexible REST API, and team collaboration features. --- **Marble is a simple, headless CMS built for writers and developers.** It helps you manage and publish content without the complexity of traditional CMS platforms. From 1ad33092df26938ab5c419510dc76b65cf11a858 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:49:58 +0000 Subject: [PATCH 02/37] Update guides/quickstart.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/quickstart.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/quickstart.mdx b/guides/quickstart.mdx index 6c3c0e6..8119fe5 100644 --- a/guides/quickstart.mdx +++ b/guides/quickstart.mdx @@ -1,6 +1,6 @@ --- -title: "Quickstart" -description: "This guide will walk you through setting up your Marble account and creating your first workspace." +title: Quickstart guide for Marble CMS +description: Set up your Marble CMS account, create your first workspace, and publish your first post in minutes. Step-by-step tutorial for getting started with Marble headless CMS. --- From 9332bdb760ef79c36d6a0b916ea523c781253b29 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:00 +0000 Subject: [PATCH 03/37] Update api/introduction.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/introduction.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/introduction.mdx b/api/introduction.mdx index dbff883..45a1b1e 100644 --- a/api/introduction.mdx +++ b/api/introduction.mdx @@ -1,6 +1,6 @@ --- -title: "Introduction" -description: "Welcome to the Marble API." +title: Marble API introduction +description: The Marble API is a REST API for managing headless CMS content. Access posts, categories, tags, and authors via HTTPS with JSON responses from api.marblecms.com. --- The Marble API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes and verbs. From 538784cd92ad23198f24bb6f8e2a3fc1fd8aa162 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:02 +0000 Subject: [PATCH 04/37] Update api/getting-started.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/getting-started.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/getting-started.mdx b/api/getting-started.mdx index 0e862a4..8bb7e1c 100644 --- a/api/getting-started.mdx +++ b/api/getting-started.mdx @@ -1,6 +1,6 @@ --- -title: "Getting Started" -description: "Get started with the Marble API." +title: Getting started with Marble API +description: Learn how to authenticate and make your first API request to Marble CMS. Try the API with our example workspace or use your own workspace key. --- ## Trying it out From 33d07ab8828099aa2769d91a149e2cdc7ae7c82d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:08 +0000 Subject: [PATCH 05/37] Update api/endpoint/posts.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/posts.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/endpoint/posts.mdx b/api/endpoint/posts.mdx index e3db2b6..3997040 100644 --- a/api/endpoint/posts.mdx +++ b/api/endpoint/posts.mdx @@ -1,6 +1,6 @@ --- -title: "Get All Posts" -description: "Retrieves a paginated list of posts in a workspace." +title: Get all posts from Marble API +description: Retrieve a paginated list of blog posts from your Marble CMS workspace. Filter by category, tags, or search query. Sort by publish date with customizable pagination. --- From f6033fc838fcf97b9825547fa4d08e820970d0eb Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:10 +0000 Subject: [PATCH 06/37] Update api/endpoint/post.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/post.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/endpoint/post.mdx b/api/endpoint/post.mdx index 566c9ef..4abf43a 100644 --- a/api/endpoint/post.mdx +++ b/api/endpoint/post.mdx @@ -1,6 +1,6 @@ --- -title: "Get a Single Post" -description: "Retrieves a single post by its identifier (slug or id)." +title: Get a single post by slug or ID +description: Retrieve a single blog post from Marble CMS using its slug or ID. Get post content in HTML or Markdown format with full metadata including authors, tags, and categories. --- From f8a99b610513701395fcf066a3f8325b9dc5a64f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:12 +0000 Subject: [PATCH 07/37] Update guides/integrations/nextjs.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/nextjs.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/integrations/nextjs.mdx b/guides/integrations/nextjs.mdx index add6a54..2ff7f86 100644 --- a/guides/integrations/nextjs.mdx +++ b/guides/integrations/nextjs.mdx @@ -1,6 +1,6 @@ --- -title: "Next.js" -description: "Integrate Marble in your Next.js application" +title: Integrate Marble CMS with Next.js +description: Build a blog with Marble CMS and Next.js. Fetch content via REST API, display posts with server-side rendering, and style with Tailwind Typography. Includes TypeScript examples. --- Getting your content to your Next.js site is as simple as making an API request to the Marble API. This guide will walk you through setting up a blog with Marble and Next.js. From 474dc493b7889bfb878b90318bd273f0bd565f46 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:14 +0000 Subject: [PATCH 08/37] Update guides/integrations/astro.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/astro.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/integrations/astro.mdx b/guides/integrations/astro.mdx index b03d8e3..fd57e9e 100644 --- a/guides/integrations/astro.mdx +++ b/guides/integrations/astro.mdx @@ -1,6 +1,6 @@ --- -title: "Astro" -description: "Integrate Marble in your Astro application" +title: Integrate Marble CMS with Astro +description: Use Marble CMS with Astro Content Collections. Fetch blog posts with type-safe loaders, generate static pages, and render content with full TypeScript support. --- To integrate Marble in your Astro application, you first need an Astro site. If you don't have one, you can check out the [Astro documentation](https://docs.astro.build/en/tutorial/0-introduction/) to get started, or use our [Astro blog template](https://github.com/usemarble/astro-example) for a ready-to-go solution. From bfb44a77be1fb1e4631a30f9a9af734abb21332f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:26 +0000 Subject: [PATCH 09/37] Update api/endpoint/tags.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/tags.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/endpoint/tags.mdx b/api/endpoint/tags.mdx index 21488ea..274fabe 100644 --- a/api/endpoint/tags.mdx +++ b/api/endpoint/tags.mdx @@ -1,6 +1,6 @@ --- -title: "Get All Tags" -description: "Retrieves a list of all tags in a workspace." +title: Get all tags from Marble API +description: Retrieve all content tags from your Marble CMS workspace with pagination. Each tag includes name, slug, description, and post count for content organization. --- From e3ec0d6e2364c6af36fe210bc22f75111ea44443 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:28 +0000 Subject: [PATCH 10/37] Update api/endpoint/categories.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/categories.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/endpoint/categories.mdx b/api/endpoint/categories.mdx index d1927ed..62c6c31 100644 --- a/api/endpoint/categories.mdx +++ b/api/endpoint/categories.mdx @@ -1,6 +1,6 @@ --- -title: "Get All Categories" -description: "Retrieves a list of all categories in a workspace." +title: Get all categories from Marble API +description: Retrieve all content categories from your Marble CMS workspace with pagination. Each category includes name, slug, description, and post count for taxonomy management. --- From cf36142bd72573d56cab50241b75a885c9bc3a28 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:29 +0000 Subject: [PATCH 11/37] Update api/endpoint/authors.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/authors.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/endpoint/authors.mdx b/api/endpoint/authors.mdx index a314b44..15873f7 100644 --- a/api/endpoint/authors.mdx +++ b/api/endpoint/authors.mdx @@ -1,6 +1,6 @@ --- -title: "Get All Authors" -description: "Retrieves a list of all authors in a workspace." +title: Get all authors from Marble API +description: Retrieve all content authors from your Marble CMS workspace with pagination. Each author includes name, bio, role, social links, and post count. --- From cbee2cc5f676cc2b43bbcae98cea3bbc6e16a880 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:31 +0000 Subject: [PATCH 12/37] Update api/pagination.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/pagination.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/pagination.mdx b/api/pagination.mdx index 82220aa..f76c191 100644 --- a/api/pagination.mdx +++ b/api/pagination.mdx @@ -1,6 +1,6 @@ --- -title: "Pagination" -description: "Learn how to use pagination in the Marble API." +title: Marble API pagination guide +description: Learn how to use offset-based pagination in Marble CMS API. Control page size, navigate pages, and handle pagination metadata for posts, categories, tags, and authors. --- Marble API uses offset-based pagination for endpoints that return multiple items. Pagination metadata is included in every response to help you navigate through large datasets efficiently. From f8bcba0a164072d71e70bca1c0ee80a8620fde86 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:34 +0000 Subject: [PATCH 13/37] Update api/types.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/types.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/types.mdx b/api/types.mdx index b12d002..6c97b04 100644 --- a/api/types.mdx +++ b/api/types.mdx @@ -1,6 +1,6 @@ --- -title: "TypeScript Types" -description: "TypeScript type definitions for Marble API responses." +title: TypeScript types for Marble API +description: Complete TypeScript type definitions and Zod schemas for Marble CMS API responses. Includes types for posts, authors, categories, tags, and pagination with npm package. --- This page provides TypeScript type definitions for all Marble API responses. These types can be used to ensure type safety when integrating Marble with TypeScript projects. From 365ba868978c1e6a5c5f91a2d4971816fe2be647 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:41 +0000 Subject: [PATCH 14/37] Update api/rate-limits.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/rate-limits.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/rate-limits.mdx b/api/rate-limits.mdx index fb4a45f..807f2b8 100644 --- a/api/rate-limits.mdx +++ b/api/rate-limits.mdx @@ -1,6 +1,6 @@ --- -title: "Rate Limits" -description: "Understand how Marble API rate limiting works and what quotas apply to your requests." +title: Marble API rate limits and quotas +description: Understand Marble CMS API rate limiting with 200 requests per 10 seconds per workspace. Learn about rate limit headers, 429 errors, and best practices for handling limits. --- Marble applies global rate limits to protect the stability of the API for all users. This page explains the limits, how they are calculated, and how to design your integration to handle them gracefully. From 4f5e2037860f4949f25f2c89ac0d9aebcb428ad7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:55 +0000 Subject: [PATCH 15/37] Update guides/integrations/tanstack.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/tanstack.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/integrations/tanstack.mdx b/guides/integrations/tanstack.mdx index fd6f0ec..b6a88bf 100644 --- a/guides/integrations/tanstack.mdx +++ b/guides/integrations/tanstack.mdx @@ -1,6 +1,6 @@ --- -title: "TanStack Start" -description: "Integrate Marble in your TanStack Start application" +title: Integrate Marble CMS with TanStack Start +description: Build a blog with Marble CMS and TanStack Start. Use server functions to fetch content, create dynamic routes, and style with Tailwind Typography. Full TypeScript support. --- Getting your content to your TanStack Start site is as simple as making an API request to the Marble API. This guide will walk you through setting up a blog with Marble and TanStack Start. From 4170618bb92855df0590ebcfd302751cfb4a84c8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:57 +0000 Subject: [PATCH 16/37] Update guides/features/webhooks.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/features/webhooks.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/features/webhooks.mdx b/guides/features/webhooks.mdx index 5645af7..6bb6a1e 100644 --- a/guides/features/webhooks.mdx +++ b/guides/features/webhooks.mdx @@ -1,6 +1,6 @@ --- -title: Webhooks -description: Using webhooks to trigger builds and automate workflows. +title: Marble CMS webhooks for automation +description: Use Marble CMS webhooks to trigger builds, revalidate content, and automate workflows. Powered by Upstash QStash with signature verification for security. tag: "NEW" --- From 9e1e7f64c175bd734e240c2e4de9f95c53f6d5ca Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:50:59 +0000 Subject: [PATCH 17/37] Update guides/features/import.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/features/import.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/features/import.mdx b/guides/features/import.mdx index d453409..5f5d896 100644 --- a/guides/features/import.mdx +++ b/guides/features/import.mdx @@ -1,6 +1,6 @@ --- -title: Importing -description: See which Markdown and MDX syntax Marble supports when you import existing content. +title: Import Markdown and MDX to Marble CMS +description: Import existing Markdown and MDX files to Marble CMS. Supports headings, lists, links, images, code blocks, and preserves MDX components for your application. --- You can bring your existing `.md` and `.mdx` files into Marble. During import, Marble preserves the most commonly used Markdown and MDX syntax so you do not have to rewrite your content. From 827df61104ad919d68cc2c9431acba09d8bc95a6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:00 +0000 Subject: [PATCH 18/37] Update guides/features/extra/reading-time.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/features/extra/reading-time.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/features/extra/reading-time.mdx b/guides/features/extra/reading-time.mdx index 97f9188..99cc539 100644 --- a/guides/features/extra/reading-time.mdx +++ b/guides/features/extra/reading-time.mdx @@ -1,6 +1,6 @@ --- -title: "Reading Time" -description: "How to display reading time for posts." +title: Calculate reading time for blog posts +description: Display estimated reading time for Marble CMS blog posts. Simple JavaScript function based on 238 words per minute average reading speed. --- Some blogs like to show an estimated reading time for each post. Marble provides these estimates inside the editor interface, but you can also display them on the frontend of your site. From 24509bc2cf8982acb82c54a55679c58f4c0dab31 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:11 +0000 Subject: [PATCH 19/37] Update guides/introduction.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/introduction.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/guides/introduction.mdx b/guides/introduction.mdx index e69bf86..7d91713 100644 --- a/guides/introduction.mdx +++ b/guides/introduction.mdx @@ -3,7 +3,11 @@ title: Introduction to Marble CMS description: Marble is a simple, headless CMS built for writers and developers. Manage and publish content with a clean editor, flexible REST API, and team collaboration features. --- -**Marble is a simple, headless CMS built for writers and developers.** It helps you manage and publish content without the complexity of traditional CMS platforms. +Marble is a simple, headless CMS built for writers and developers. It helps you manage and publish content without the complexity of traditional CMS platforms. + +## What is Marble CMS? + +Marble CMS is a headless content management system that provides a clean writing interface and a flexible REST API. Unlike traditional CMS platforms, Marble separates content management from presentation, allowing you to use any frontend framework like Next.js, Astro, or TanStack Start. ## Why use Marble? From 84608a75684375e7926e839240f718e234d166ba Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:20 +0000 Subject: [PATCH 20/37] Update api/introduction.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/introduction.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/api/introduction.mdx b/api/introduction.mdx index 45a1b1e..bd3a7aa 100644 --- a/api/introduction.mdx +++ b/api/introduction.mdx @@ -3,7 +3,11 @@ title: Marble API introduction description: The Marble API is a REST API for managing headless CMS content. Access posts, categories, tags, and authors via HTTPS with JSON responses from api.marblecms.com. --- -The Marble API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes and verbs. +## What is the Marble API? + +The Marble API is a RESTful API for managing headless CMS content. It provides programmatic access to your blog posts, authors, categories, and tags through simple HTTP requests. + +The API is organized around REST principles with predictable resource-oriented URLs, JSON-encoded responses, and standard HTTP response codes and verbs. ## Base URL From 75b29febbc6cc45ab4519e9ce125d0d0b420b7f9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:22 +0000 Subject: [PATCH 21/37] Update guides/quickstart.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/quickstart.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/quickstart.mdx b/guides/quickstart.mdx index 8119fe5..4ff1eca 100644 --- a/guides/quickstart.mdx +++ b/guides/quickstart.mdx @@ -5,7 +5,7 @@ description: Set up your Marble CMS account, create your first workspace, and pu -To get started, head over to [marblecms.com](https://marblecms.com) and click the **Sign Up** button. You can sign up with your email, Google, or a GitHub account. +To get started with Marble CMS, head over to [marblecms.com](https://marblecms.com) and click the **Sign Up** button. You can sign up with your email, Google, or a GitHub account. From 36d46a97867b1b5e66b6d24a3e220091079689f9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:30 +0000 Subject: [PATCH 22/37] Update api/endpoint/posts.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/posts.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/api/endpoint/posts.mdx b/api/endpoint/posts.mdx index 3997040..85bbfdb 100644 --- a/api/endpoint/posts.mdx +++ b/api/endpoint/posts.mdx @@ -3,6 +3,10 @@ title: Get all posts from Marble API description: Retrieve a paginated list of blog posts from your Marble CMS workspace. Filter by category, tags, or search query. Sort by publish date with customizable pagination. --- +## Overview + +Use this endpoint to retrieve all published blog posts from your Marble CMS workspace. The response includes post metadata, content, authors, categories, and tags with pagination support. + ```bash cURL curl "https://api.marblecms.com/v1/cm6ytuq9x0000i803v0isidst/posts" From 1a3a7d39f550f31f057e470190c0c9ac16acb44d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:35 +0000 Subject: [PATCH 23/37] Update api/endpoint/post.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/post.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/api/endpoint/post.mdx b/api/endpoint/post.mdx index 4abf43a..59261ee 100644 --- a/api/endpoint/post.mdx +++ b/api/endpoint/post.mdx @@ -3,6 +3,10 @@ title: Get a single post by slug or ID description: Retrieve a single blog post from Marble CMS using its slug or ID. Get post content in HTML or Markdown format with full metadata including authors, tags, and categories. --- +## Overview + +Use this endpoint to retrieve a single blog post from your Marble CMS workspace by its slug or ID. You can request content in HTML or Markdown format. + ```bash cURL (by slug) curl "https://api.marblecms.com/v1/cm6ytuq9x0000i803v0isidst/posts/introducing-marblecms" From b92d51218a93e6d39efcd44886218d153d40442d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:39 +0000 Subject: [PATCH 24/37] Update guides/integrations/astro.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/astro.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/guides/integrations/astro.mdx b/guides/integrations/astro.mdx index fd57e9e..3c36d90 100644 --- a/guides/integrations/astro.mdx +++ b/guides/integrations/astro.mdx @@ -3,6 +3,10 @@ title: Integrate Marble CMS with Astro description: Use Marble CMS with Astro Content Collections. Fetch blog posts with type-safe loaders, generate static pages, and render content with full TypeScript support. --- +## Overview + +This guide shows you how to integrate Marble CMS with Astro using Content Collections. You'll learn how to fetch blog posts with type-safe loaders, generate static pages, and render content with full TypeScript support. + To integrate Marble in your Astro application, you first need an Astro site. If you don't have one, you can check out the [Astro documentation](https://docs.astro.build/en/tutorial/0-introduction/) to get started, or use our [Astro blog template](https://github.com/usemarble/astro-example) for a ready-to-go solution. Astro's **Content Collections** are the best way to manage content in your project. We'll use a **Content Loader** to fetch your posts from Marble and make them available in your Astro site with full type-safety. You can learn more about this in the [Astro Content Collections documentation](https://docs.astro.build/en/guides-collections/). From a98234b748965207d6f3a6f6c7f3f09f94c3c2b5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:45 +0000 Subject: [PATCH 25/37] Update guides/integrations/nextjs.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/nextjs.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/guides/integrations/nextjs.mdx b/guides/integrations/nextjs.mdx index 2ff7f86..bf213da 100644 --- a/guides/integrations/nextjs.mdx +++ b/guides/integrations/nextjs.mdx @@ -3,7 +3,11 @@ title: Integrate Marble CMS with Next.js description: Build a blog with Marble CMS and Next.js. Fetch content via REST API, display posts with server-side rendering, and style with Tailwind Typography. Includes TypeScript examples. --- -Getting your content to your Next.js site is as simple as making an API request to the Marble API. This guide will walk you through setting up a blog with Marble and Next.js. +## Overview + +This guide shows you how to integrate Marble CMS with Next.js to build a blog. You'll learn how to fetch content from the Marble API, display posts with server-side rendering, and style content with Tailwind Typography. + +Getting your content to your Next.js site is as simple as making an API request to the Marble API. If you want to get started quickly, you can clone our [Next.js blog template](https://github.com/usemarble/nextjs-example). From defc4707301a77a0685e862d1475c37ff9643197 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:47 +0000 Subject: [PATCH 26/37] Update guides/integrations/tanstack.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/tanstack.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/guides/integrations/tanstack.mdx b/guides/integrations/tanstack.mdx index b6a88bf..a7ff0d8 100644 --- a/guides/integrations/tanstack.mdx +++ b/guides/integrations/tanstack.mdx @@ -3,7 +3,11 @@ title: Integrate Marble CMS with TanStack Start description: Build a blog with Marble CMS and TanStack Start. Use server functions to fetch content, create dynamic routes, and style with Tailwind Typography. Full TypeScript support. --- -Getting your content to your TanStack Start site is as simple as making an API request to the Marble API. This guide will walk you through setting up a blog with Marble and TanStack Start. +## Overview + +This guide shows you how to integrate Marble CMS with TanStack Start to build a blog. You'll learn how to use server functions to fetch content, create dynamic routes, and style with Tailwind Typography. + +Getting your content to your TanStack Start site is as simple as making an API request to the Marble API. If you want to get started quickly, you can clone our [TanStack Start blog template](https://github.com/usemarble/tanstack-start-example). From 0c4c0c8b02f5a03a59f8ffc128412d3c14e1e435 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:51:57 +0000 Subject: [PATCH 27/37] Update api/getting-started.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/getting-started.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/getting-started.mdx b/api/getting-started.mdx index 8bb7e1c..1a6bf59 100644 --- a/api/getting-started.mdx +++ b/api/getting-started.mdx @@ -3,9 +3,9 @@ title: Getting started with Marble API description: Learn how to authenticate and make your first API request to Marble CMS. Try the API with our example workspace or use your own workspace key. --- -## Trying it out +## Try the API without an account -Throughout this documentation, we use an example workspace ID: `cm6ytuq9x0000i803v0isidst`. You can use this ID to make live API requests and see real responses without needing an account. +Throughout this documentation, we use an example workspace ID: `cm6ytuq9x0000i803v0isidst`. You can use this workspace ID to make live API requests and see real responses without creating a Marble CMS account. Try it now! Copy and paste this command into your terminal to fetch posts from our example workspace: From e5d459facc6d62c5a10e62cf8910b25d68e837af Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:06 +0000 Subject: [PATCH 28/37] Update api/pagination.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/pagination.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/api/pagination.mdx b/api/pagination.mdx index f76c191..269fd89 100644 --- a/api/pagination.mdx +++ b/api/pagination.mdx @@ -3,11 +3,13 @@ title: Marble API pagination guide description: Learn how to use offset-based pagination in Marble CMS API. Control page size, navigate pages, and handle pagination metadata for posts, categories, tags, and authors. --- -Marble API uses offset-based pagination for endpoints that return multiple items. Pagination metadata is included in every response to help you navigate through large datasets efficiently. +## What is pagination? -## How Pagination Works +Marble API uses offset-based pagination for endpoints that return multiple items. Pagination allows you to retrieve large datasets in smaller, manageable chunks rather than loading everything at once. -When you request a list of resources (like posts), the API automatically includes pagination information in the response. This allows you to: +## How pagination works in Marble API + +When you request a list of resources (like posts, categories, or tags), the API automatically includes pagination metadata in every response. This allows you to: - Control how many items are returned per request - Navigate to specific pages From f239188db91ed1399717ebaa90f9172c62aa3ff6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:16 +0000 Subject: [PATCH 29/37] Update api/rate-limits.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/rate-limits.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/rate-limits.mdx b/api/rate-limits.mdx index 807f2b8..f5a27da 100644 --- a/api/rate-limits.mdx +++ b/api/rate-limits.mdx @@ -5,9 +5,9 @@ description: Understand Marble CMS API rate limiting with 200 requests per 10 se Marble applies global rate limits to protect the stability of the API for all users. This page explains the limits, how they are calculated, and how to design your integration to handle them gracefully. -## Overview +## What are rate limits? -Marble API uses rate limiting to ensure fair usage and API stability. Rate limits are enforced per workspace using a sliding window approach. +Rate limits control how many API requests you can make within a specific time window. Marble API uses rate limiting to ensure fair usage and API stability for all users. Rate limits are enforced per workspace using a sliding window approach. Most applications will not hit these limits during normal use, but you should still build in defensive handling for rate limit responses. From aaa4fef384d6e066c140b0d2b4c5a416de185c4f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:21 +0000 Subject: [PATCH 30/37] Update guides/features/webhooks.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/features/webhooks.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/guides/features/webhooks.mdx b/guides/features/webhooks.mdx index 6bb6a1e..906cff9 100644 --- a/guides/features/webhooks.mdx +++ b/guides/features/webhooks.mdx @@ -4,7 +4,11 @@ description: Use Marble CMS webhooks to trigger builds, revalidate content, and tag: "NEW" --- -Webhooks provide a powerful way to keep your site's content fresh and automate workflows. When an event occurs in your Marble workspace (like publishing a post), we can send an HTTP POST payload to a URL you configure. Webhooks are powered by [Upstash QStash](https://upstash.com?utm_source=marble-docs), ensuring reliable delivery of events. +## What are webhooks? + +Webhooks provide a powerful way to keep your site's content fresh and automate workflows. When an event occurs in your Marble CMS workspace (like publishing a post), Marble sends an HTTP POST request with event data to a URL you configure. + +Marble webhooks are powered by [Upstash QStash](https://upstash.com?utm_source=marble-docs), ensuring reliable delivery of events with automatic retries. ## Use cases From fe4ae83e46323e7a7e03c54da84a43392bf4f700 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:30 +0000 Subject: [PATCH 31/37] Update api/endpoint/posts.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/endpoint/posts.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/api/endpoint/posts.mdx b/api/endpoint/posts.mdx index 85bbfdb..c88ca50 100644 --- a/api/endpoint/posts.mdx +++ b/api/endpoint/posts.mdx @@ -124,6 +124,5 @@ Use query parameters to paginate, sort, and filter the results. Responses include a `pagination` object with `limit`, `currentPage`, `previousPage`, `nextPage`, `totalPages`, and `totalItems`. For advanced usage - and error cases (like invalid page numbers), see the full guide on - Pagination. + and error cases (like invalid page numbers), see the [Pagination guide](/api/pagination). From c187caaa44f0a685ee5cbffdc3b09db986a9337b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:32 +0000 Subject: [PATCH 32/37] Update guides/integrations/nextjs.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/nextjs.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/guides/integrations/nextjs.mdx b/guides/integrations/nextjs.mdx index bf213da..1c65692 100644 --- a/guides/integrations/nextjs.mdx +++ b/guides/integrations/nextjs.mdx @@ -38,9 +38,7 @@ To make it easier to fetch data from Marble, you can create a utility file to wr Create a file at `lib/query.ts` (or `.js` if you're using JavaScript). - For complete TypeScript type definitions, see our [TypeScript Types - reference](/api/types). The server functions below use these types for full - type safety. + For complete TypeScript type definitions, see our [TypeScript types reference](/api/types). The server functions below use these types for full type safety. ```typescript lib/query.ts From 42abc86d36ca8ec41e6a532acf191a8e607097d4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:33 +0000 Subject: [PATCH 33/37] Update guides/integrations/astro.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/astro.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/guides/integrations/astro.mdx b/guides/integrations/astro.mdx index 3c36d90..91ee63a 100644 --- a/guides/integrations/astro.mdx +++ b/guides/integrations/astro.mdx @@ -37,8 +37,7 @@ Next, define your content collection. This tells Astro how to fetch and validate This configuration defines a `posts` collection, and includes a loader function that fetches your posts from the Marble API. - For complete TypeScript type definitions, see our [Types - reference](/api/types). The schema below matches the `Post` type from the API. + For complete TypeScript type definitions, see our [TypeScript types reference](/api/types). The schema below matches the `Post` type from the Marble API. ```typescript src.config.ts From b1acc47ddab59478fc35923c5a84b2675e5113a1 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:35 +0000 Subject: [PATCH 34/37] Update guides/integrations/tanstack.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/integrations/tanstack.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/guides/integrations/tanstack.mdx b/guides/integrations/tanstack.mdx index a7ff0d8..3bc6edb 100644 --- a/guides/integrations/tanstack.mdx +++ b/guides/integrations/tanstack.mdx @@ -48,9 +48,7 @@ npm install zod ``` - For complete TypeScript type definitions, see our [TypeScript Types - reference](/api/types). The server functions below use these types for - full type safety. + For complete TypeScript type definitions, see our [TypeScript types reference](/api/types). The server functions below use these types for full type safety. ```typescript lib/query.ts From d5276c1cbd89aa8730eba53ee49320a52aca224b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:49 +0000 Subject: [PATCH 35/37] Update guides/quickstart.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/quickstart.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/guides/quickstart.mdx b/guides/quickstart.mdx index 4ff1eca..a5bf1b2 100644 --- a/guides/quickstart.mdx +++ b/guides/quickstart.mdx @@ -90,12 +90,14 @@ When you're ready, you can save your post as a draft or publish it immediately. That's it! You've successfully set up your Marble workspace and created your first post. 🚀 -Now you're ready to connect your content to your frontend. Check out our integration guides to get started. For faster integration, add the [Context7 MCP server](https://context7.com/websites/marblecms) to your setup. +Now you're ready to connect your content to your frontend. Check out our [integration guides](/guides/integrations/nextjs) to get started. For faster integration, add the [Context7 MCP server](https://context7.com/websites/marblecms) to your setup. + +You can also explore the [Marble API documentation](/api/introduction) to learn more about available endpoints. From cff40a4b19ec6a82778fc4656ea4c9d042628334 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:50 +0000 Subject: [PATCH 36/37] Update guides/features/webhooks.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/features/webhooks.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/features/webhooks.mdx b/guides/features/webhooks.mdx index 906cff9..efc8ac1 100644 --- a/guides/features/webhooks.mdx +++ b/guides/features/webhooks.mdx @@ -153,7 +153,7 @@ export async function POST(request: Request) { } ``` -If you want a better guide on how to invalidate cache in your framework of choice, you can check out our blog post on [Using Marble's Webhooks with the Next.js App Router](https://marblecms.com/blog/nextjs-webhooks-with-marble). +For a detailed guide on cache invalidation in Next.js, see our blog post on [Using Marble's Webhooks with the Next.js App Router](https://marblecms.com/blog/nextjs-webhooks-with-marble). For other frameworks, check our [integration guides](/guides/integrations/nextjs). Marble will send the signature in the `x-marble-signature` header of the request. You can use this signature to verify the authenticity of the request. Make sure to add the `process.env.MARBLE_WEBHOOK_SECRET` environment variable. From b3a62e2777c3c31a80600ae11b9d8f1675a630e4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 10 Dec 2025 07:52:51 +0000 Subject: [PATCH 37/37] Update api/types.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- api/types.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/types.mdx b/api/types.mdx index 6c97b04..c4caf4d 100644 --- a/api/types.mdx +++ b/api/types.mdx @@ -126,7 +126,7 @@ export type MarbleAuthorListResponse = { ``` -Copy these type definitions into a `types/marble.ts` file in your project. If you prefer a published package, we also provide an official npm package that exports these types . +Copy these type definitions into a `types/marble.ts` file in your project. If you prefer a published package, we also provide an official npm package `@usemarble/core` that exports these types. ### NPM package