REST Endpoints

https://your-cms.your-account.workers.dev/api

http://localhost:8787/api

{
  "data": [],
  "meta": {
    "count": 10,
    "timestamp": "2026-03-08T12:00:00.000Z",
    "cache": {
      "hit": false,
      "source": "database"
    },
    "timing": {
      "total": 45,
      "execution": 12,
      "unit": "ms"
    }
  }
}

curl "http://localhost:8787/api/collections/blog-posts/content?status=published&limit=10"

const response = await fetch(
  'http://localhost:8787/api/collections/blog-posts/content?status=published&limit=10'
)
const { data, meta } = await response.json()
 
console.log(`Found ${meta.count} posts (${meta.timing.total}ms)`)
data.forEach(post => {
  console.log(post.title, post.slug)
})

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Getting Started with Flare CMS",
      "slug": "getting-started-with-flare-cms",
      "status": "published",
      "collectionId": "coll-uuid-here",
      "data": {
        "content": "<p>Welcome to Flare CMS...</p>",
        "featuredImage": "https://images.flarecms.dev/uploads/hero.jpg"
      },
      "created_at": 1709856000000,
      "updated_at": 1709942400000
    }
  ],
  "meta": {
    "count": 1,
    "timestamp": "2026-03-08T12:00:00.000Z",
    "cache": { "hit": false, "source": "database" },
    "timing": { "total": 23, "execution": 8, "unit": "ms" }
  }
}

curl "http://localhost:8787/api/content/a1b2c3d4-e5f6-7890-abcd-ef1234567890"

const response = await fetch(
  `http://localhost:8787/api/content/${contentId}`
)
const { data } = await response.json()
 
console.log(data.title)
console.log(data.data.content)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Getting Started with Flare CMS",
    "slug": "getting-started-with-flare-cms",
    "status": "published",
    "collectionId": "coll-uuid-here",
    "data": {
      "content": "<p>Welcome to Flare CMS...</p>"
    },
    "created_at": 1709856000000,
    "updated_at": 1709942400000
  }
}

curl -X POST "http://localhost:8787/api/content" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "collectionId": "coll-uuid-here",
    "title": "My New Post",
    "slug": "my-new-post",
    "status": "draft",
    "data": {
      "content": "<p>Hello world</p>",
      "excerpt": "A short summary"
    }
  }'

const response = await fetch('http://localhost:8787/api/content', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`,
  },
  body: JSON.stringify({
    collectionId: 'coll-uuid-here',
    title: 'My New Post',
    slug: 'my-new-post',
    status: 'draft',
    data: {
      content: '<p>Hello world</p>',
      excerpt: 'A short summary',
    },
  }),
})
 
const { data } = await response.json()
console.log('Created:', data.id)

{
  "data": {
    "id": "new-uuid-here",
    "title": "My New Post",
    "slug": "my-new-post",
    "status": "draft",
    "collectionId": "coll-uuid-here",
    "data": {
      "content": "<p>Hello world</p>",
      "excerpt": "A short summary"
    },
    "created_at": 1709942400000,
    "updated_at": 1709942400000
  }
}

curl -X POST "http://localhost:8787/api/media/upload" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -F "file=@./photo.jpg" \
  -F "folder=blog-images"

const formData = new FormData()
formData.append('file', fileBlob, 'photo.jpg')
formData.append('folder', 'blog-images')
 
const response = await fetch('http://localhost:8787/api/media/upload', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
  body: formData,
})
 
const result = await response.json()
console.log('Uploaded to:', result.data.url)

{
  "error": "Content not found"
}

{
  "error": "Failed to create content",
  "details": "UNIQUE constraint failed: content.slug"
}

# wrangler.toml
[vars]
CORS_ORIGINS = "https://your-site.com,http://localhost:4321"