Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.marblecms.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Quick Start

Make your first API request in seconds! Copy and paste this command into your terminal: 
curl -H "Authorization: YOUR_API_KEY" https://api.marblecms.com/v1/posts
Replace YOUR_API_KEY with an API key from your Marble dashboard.

​
Creating an API Key

1

Open your workspace settings

Navigate to your workspace dashboard and click Settings in the sidebar.
2

Go to API Keys

Click on API Keys in the settings menu.
3

Create a new key

Click Create API Key, give it a descriptive name (e.g., “Production Website”), and select the appropriate permissions.
4

Copy your key

Your API key will only be shown once. Copy it and store it securely.
API keys should be kept secure. While public keys are read-only, exposing them in client-side code can lead to your rate limits being consumed by others. We recommend performing API requests on the server-side whenever possible.

​
Authentication

Include your API key in the Authorization header: 
curl -H "Authorization: YOUR_API_KEY" https://api.marblecms.com/v1/posts
Alternatively, use the key query parameter: 
curl "https://api.marblecms.com/v1/posts?key=YOUR_API_KEY"
The Authorization header method is recommended for security. Query parameters may appear in server logs.

​
Available Resources

  • Posts: List, get, create, update, or delete posts
  • Authors: List, get, create, update, or delete authors
  • Categories: List, get, create, update, or delete categories
  • Tags: List, get, create, update, or delete tags
  • Media: List, get, upload, update, or delete media assets

​
Next Steps

Pagination

Learn how to paginate through large result sets.

Rate Limits

Understand API rate limiting and best practices.

TypeScript Types

Use our TypeScript definitions for type-safe development.