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
Open your workspace settings
Navigate to your workspace dashboard and click Settings in the sidebar.
Go to API Keys
Click on API Keys in the settings menu.
Create a new key
Click Create API Key, give it a descriptive name (e.g., “Production
Website”), and select the appropriate permissions.
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
const response = await fetch("https://api.marblecms.com/v1/posts", {
headers: {
Authorization: "YOUR_API_KEY",
},
});
const data = await response.json();
console.log(data);
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
Next Steps
