joelmale-blog

Publish and update blog posts to joelmale.com via API.

Auth

•Bearer token stored in ~/.clawdbot/credentials/joelmale-blog-token.txt
•Never log or commit this token
•Token: Authorization: Bearer <token>

Available Categories

Always choose from this list. Fetch from API if unsure.

ID	Name	Slug
1	Dev	dev
2	Careers	careers
3	Thoughts	thoughts
4	Announcements	announcements
5	eCommerce	ecommerce

API Endpoints

Get Categories

bash

curl -X GET https://joelmale.com/api/blog/categories \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

List Posts

bash

curl -X GET https://joelmale.com/api/blog/posts \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Get Single Post

bash

curl -X GET https://joelmale.com/api/blog/posts/1 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Create Post (Draft)

bash

curl -X POST https://joelmale.com/api/blog/posts \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "post-slug-here",
    "title": "Post Title",
    "excerpt": "Summary for listings",
    "seo_title": "SEO Title (70 chars)",
    "seo_description": "SEO description (160 chars)",
    "content": "# Markdown content here",
    "status": "draft",
    "tags": ["tag1", "tag2", "tag3"],
    "category_ids": [1],
    "featured_image": "https://example.com/image.jpg OR base64_encoded_string",
    "featured_image_filename": "optional-filename.jpg"
  }'

Update Post

bash

curl -X PUT https://joelmale.com/api/blog/posts/{id} \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Title",
    "excerpt": "Updated excerpt",
    "seo_title": "Updated SEO Title",
    "seo_description": "Updated SEO description",
    "content": "# Updated content",
    "status": "draft",
    "tags": ["tag1", "tag2"],
    "category_ids": [1],
    "featured_image": "https://example.com/image.jpg OR base64_encoded_string",
    "featured_image_filename": "optional-filename.jpg"
  }'

Featured Image

The featured_image field accepts either:

•URL: Direct link to an image (e.g., "https://example.com/image.jpg")
•Base64: Base64-encoded image data (for uploading new images)

The featured_image_filename is optional but recommended when sending base64 data (helps the backend determine file type/extension).

Example with URL:

json

"featured_image": "https://joelmale.com/images/laravel-upgrade-hero.jpg"

Example with base64:

json

"featured_image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"featured_image_filename": "laravel-upgrade-hero.jpg"

Tagging Guidelines

Always add tags. They're for searchability. Examples:

•Technical posts: ["laravel", "devops", "testing", "deployment"]
•Business posts: ["saas", "startups", "pricing", "metrics"]
•Updates: ["announcements", "release-notes"]

Workflow

When Joel asks to create/update a blog post:

•Confirm category — Ask if unsure, or infer from content
•Generate tags — Read content, extract 4-8 relevant terms
•Create/update via API — Always use draft status initially
•Send admin URL — Joel reviews at /dash/admin/posts/{id}/edit before publishing

Example tags by content:

•Laravel posts → laravel, composer, php, deployment, testing
•Case studies → client work, case-study, pixel, results
•DevOps → devops, linux, docker, automation, infrastructure