Blog

Writing preferences

Set your default writing style, tone, and tags so the AI agent can match your voice when helping draft posts.

curl -X PUT https://wrok-agent.fly.dev/api/v1/blog-preferences \
  -H "Authorization: Bearer $WROK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "writing_style": "technical",
    "tone": "conversational",
    "default_tags": ["engineering", "career"],
    "default_category": "tech"
  }'

Create a post

curl -X POST https://wrok-agent.fly.dev/api/v1/blog-posts \
  -H "Authorization: Bearer $WROK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Why I Switched from Node to Go",
    "content": "After 5 years of writing Node.js backends...",
    "description": "A practical comparison after migrating a production system.",
    "tags": ["go", "nodejs", "backend"],
    "category": "tech"
  }'

Posts are created as drafts by default. Add "published": true to publish immediately.

Publish and unpublish

# Publish
curl -X POST https://wrok-agent.fly.dev/api/v1/blog-posts/{post_id}/publish \
  -H "Authorization: Bearer $WROK_KEY"

# Unpublish (revert to draft)
curl -X POST https://wrok-agent.fly.dev/api/v1/blog-posts/{post_id}/unpublish \
  -H "Authorization: Bearer $WROK_KEY"

Published posts appear on your public profile at /p/your-slug/blog.

Manage posts

# List all posts
curl https://wrok-agent.fly.dev/api/v1/blog-posts \
  -H "Authorization: Bearer $WROK_KEY"

# Get a specific post
curl https://wrok-agent.fly.dev/api/v1/blog-posts/{post_id} \
  -H "Authorization: Bearer $WROK_KEY"

# Update a post
curl -X PUT https://wrok-agent.fly.dev/api/v1/blog-posts/{post_id} \
  -H "Authorization: Bearer $WROK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Updated content..."}'

# Delete a post
curl -X DELETE https://wrok-agent.fly.dev/api/v1/blog-posts/{post_id} \
  -H "Authorization: Bearer $WROK_KEY"