Skip to main content

​
Quick Start

Make your first API request in seconds! Copy and paste this command into your terminal: 
curl -H "Authorization: Bearer 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: Bearer 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 Endpoints

Posts

Retrieve all published posts with filtering and pagination.

Single Post

Get a specific post by slug or ID.

Categories

List all content categories.

Tags

Browse all content tags.

Authors

Get author information.

​
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.