Skill: Blog Posts

Description

Manage blog posts and AI-powered writing workflows. This skill documents PublicApiBlogPostController at /api/v2/blog-posts. Authenticate with X-API-KEY.

Key async behaviors:

• Outline/full/section generation returns activityId → poll GET /api/v2/jobs/{activityId}.
• Blog post “generate” returns aiEditLiveObjectId → poll GET /api/v2/blog-posts/{blog_post_id}/generation/{ai_edit_id}, then POST accept to commit.
• AI operations return aiOperationId → poll GET /api/v2/blog-posts/{blog_post_id}/ai-operations/{ai_operation_id}, then POST accept to apply.
• Exports return exportId → poll GET /api/v2/blog-posts/{blog_post_id}/exports/{export_id} (not the jobs endpoint).

TypeScript types (selected)

Mirrors the request/response DTOs in service-poc/service/app/module-client/.../publicapi/blogpost/*.