Introduction

Diggama is a headless CMS that lets you model, manage, and deliver content through a powerful API. Define your data structures with blueprints, write and publish content in the dashboard at manage.diggama.com, and consume it from any frontend: static site generators, mobile apps, or SPAs.

Key features

Feature	Description
Blueprints	Flexible data modeling with 21 field types: text, images, relations, money, addresses, and a page builder
Resources API	Full CRUD with advanced filtering, sorting, search, and bulk operations
Editor	A rich-text editor with images and video, a shared media library, autosave and SEO scoring
Variants	Multilingual content out of the box: every endpoint supports a `variant` parameter
Workflows	Automations that publish, send emails or call webhooks when content changes
MCP server	Connect your project to Claude, Cursor or any MCP client. The AI reads and writes your content within your token's permissions
Granular permissions	Scope tokens per blueprint and ability (view, preview, create, update, delete, publish)

Quick start

1. Create a blueprint

In the Diggama dashboard, create a blueprint (e.g. blog-posts) and add fields like title (Text), slug (Slug), content (Rich text), and cover (Image).

2. Generate an API token

Open Settings › API Tokens (at the bottom of the sidebar) and create a token. Grant it the abilities you need (e.g. view on blog-posts).

3. Fetch your content

bash

curl "https://api.diggama.com/v2/resources/blog-posts" \
  -H "Authorization: Bearer {token}"

json

{
  "data": [
    {
      "id": "gKqv6dx6pBk9",
      "type": "resource",
      "published_at": "2026-02-01T12:00:00+00:00",
      "created_at": "2026-01-28T09:15:00+00:00",
      "updated_at": "2026-02-01T12:00:00+00:00",
      "attributes": {
        "title": "Getting started with Diggama",
        "slug": "getting-started",
        "content": "<p>Welcome to your new headless CMS.</p>",
        "cover": "https://cdn.diggama.com/images/cover.jpg"
      },
      "relationships": {
        "blueprint": {
          "data": { "id": "blog-posts", "type": "blueprint" }
        }
      }
    }
  ],
  "meta": { "current_page": 1, "per_page": 25, "total": 1, "last_page": 1, "from": 1, "to": 1 }
}

4. Integrate with your frontend

Use the response data in any framework. Here's an example with Astro:

javascript

// src/pages/blog/index.astro
const response = await fetch('https://api.diggama.com/v2/resources/blog-posts?sort=-published_at', {
  headers: { 'Authorization': `Bearer ${import.meta.env.DIGGAMA_TOKEN}` }
});
const { data: posts } = await response.json();

API versioning

The current API version is V2. The base URL for all API endpoints is:

https://api.diggama.com/v2/

The V1 API is deprecated. It remains available at https://api.diggama.com/v1/ for existing integrations, but receives no new features: new projects should use V2. See API v1.

What's next?

Blueprints: Learn how to model your content
Authentication: Set up API tokens and permissions
Resources API: Full endpoint reference
Publishing: Understand draft and publish states
Editing content: The editor, media library and autosave
MCP server: Drive your content from Claude, Cursor or VS Code

Introduction ​

Key features ​

Quick start ​

1. Create a blueprint ​

2. Generate an API token ​

3. Fetch your content ​

4. Integrate with your frontend ​

API versioning ​

What's next? ​