# Marble Documentation

> Documentation for Marble, the simple headless CMS for writers and developers.

## Docs

- [Create author](https://docs.marblecms.com/api-reference/authors/create-author.md): Create a new author. Requires a private API key. Hobby plan is limited to 1 author.
- [Delete author](https://docs.marblecms.com/api-reference/authors/delete-author.md): Delete an author by ID or slug. Requires a private API key.
- [Get author](https://docs.marblecms.com/api-reference/authors/get-author.md): Get a single author by ID or slug
- [List authors](https://docs.marblecms.com/api-reference/authors/list-authors.md): Get a paginated list of authors who have published posts
- [Update author](https://docs.marblecms.com/api-reference/authors/update-author.md): Update an existing author by ID or slug. Requires a private API key.
- [Create category](https://docs.marblecms.com/api-reference/categories/create-category.md): Create a new category. Requires a private API key.
- [Delete category](https://docs.marblecms.com/api-reference/categories/delete-category.md): Delete a category by ID or slug. Requires a private API key. Cannot delete a category that has posts assigned to it.
- [Get category](https://docs.marblecms.com/api-reference/categories/get-category.md): Get a single category by ID or slug
- [List categories](https://docs.marblecms.com/api-reference/categories/list-categories.md): Get a paginated list of categories
- [Update category](https://docs.marblecms.com/api-reference/categories/update-category.md): Update an existing category by ID or slug. Requires a private API key.
- [Create post](https://docs.marblecms.com/api-reference/posts/create-post.md): Create a new post. Requires a private API key. Category is required. If authors are not provided, the first workspace author is used.
- [Delete post](https://docs.marblecms.com/api-reference/posts/delete-post.md): Delete a post by ID or slug. Requires a private API key.
- [Get post](https://docs.marblecms.com/api-reference/posts/get-post.md): Get a single post by ID or slug, with optional status filtering
- [List posts](https://docs.marblecms.com/api-reference/posts/list-posts.md): Get a paginated list of published posts with optional filtering
- [Update post](https://docs.marblecms.com/api-reference/posts/update-post.md): Update an existing post by ID or slug. All fields are optional — only provided fields are updated. Requires a private API key.
- [Create tag](https://docs.marblecms.com/api-reference/tags/create-tag.md): Create a new tag. Requires a private API key.
- [Delete tag](https://docs.marblecms.com/api-reference/tags/delete-tag.md): Delete a tag by ID or slug. Requires a private API key.
- [Get tag](https://docs.marblecms.com/api-reference/tags/get-tag.md): Get a single tag by ID or slug
- [List tags](https://docs.marblecms.com/api-reference/tags/list-tags.md): Get a paginated list of tags
- [Update tag](https://docs.marblecms.com/api-reference/tags/update-tag.md): Update an existing tag by ID or slug. Requires a private API key.
- [Filtering](https://docs.marblecms.com/api/filtering.md): Learn how to filter posts by categories, tags, and search queries.
- [Getting Started](https://docs.marblecms.com/api/getting-started.md): Get started with the Marble API.
- [Introduction](https://docs.marblecms.com/api/introduction.md): Welcome to the Marble API.
- [Pagination](https://docs.marblecms.com/api/pagination.md): Learn how to use pagination in the Marble API.
- [Rate Limits](https://docs.marblecms.com/api/rate-limits.md): Understand how Marble API rate limiting works and what quotas apply to your requests.
- [TypeScript Types](https://docs.marblecms.com/api/types.md): TypeScript type definitions for Marble API responses.
- [Custom Fields](https://docs.marblecms.com/guides/features/custom-fields.md): Extend your post schema with workspace-specific metadata and consume it directly from the API.
- [Editor](https://docs.marblecms.com/guides/features/editor.md): A distraction-free writing experience with powerful formatting, embeds, and AI-powered insights.
- [Importing](https://docs.marblecms.com/guides/features/import.md): See which Markdown and MDX syntax Marble supports when you import existing content.
- [Media](https://docs.marblecms.com/guides/features/media.md): Upload, manage, and serve images and videos from Marble's CDN.
- [Webhooks](https://docs.marblecms.com/guides/features/webhooks.md): Using webhooks to trigger builds and automate workflows.
- [Astro](https://docs.marblecms.com/guides/integrations/astro.md): Integrate Marble in your Astro application
- [Framer](https://docs.marblecms.com/guides/integrations/framer.md): Sync Marble content to Framer CMS with the Marble plugin
- [Next.js](https://docs.marblecms.com/guides/integrations/nextjs.md): Integrate Marble in your Next.js application
- [TanStack Start](https://docs.marblecms.com/guides/integrations/tanstack.md): Integrate Marble in your TanStack Start application
- [Introduction](https://docs.marblecms.com/guides/introduction.md): Welcome to Marble
- [Quickstart](https://docs.marblecms.com/guides/quickstart.md): This guide will walk you through setting up your Marble account and creating your first workspace.
- [Syntax Highlighting](https://docs.marblecms.com/guides/recipes/code-highlighting.md): Add syntax highlighting to code blocks in your posts
- [Reading Time](https://docs.marblecms.com/guides/recipes/reading-time.md): How to display reading time for posts.
- [TypeScript SDK](https://docs.marblecms.com/guides/sdk.md): Official Marble SDK for TypeScript.

## OpenAPI Specs

- [openapi](https://api.marblecms.com/openapi.json)

## Optional

- [Blog](https://marblecms.com/blog)
- [Community](https://discord.marblecms.com/)