Creator Platform Overview
The Creator platform (Creators Revolution) provides content creation, multi-platform social publishing, podcast distribution, and AI-assisted content generation.
Core Capabilities
| Feature | Description |
|---|---|
| Content Management | Create, schedule, and publish posts across platforms |
| Social Publishing | Distribute to Twitter, LinkedIn, Instagram, YouTube, TikTok, Mastodon |
| Podcast Distribution | Manage shows, episodes, seasons, and RSS feeds |
| Media Management | Upload and manage images, video, audio, and documents via CDN |
| AI Content Generation | AI-assisted content creation and optimization |
| Campaign Management | Organize content into campaigns with scheduling |
Architecture
The Creator platform runs as a Rust microservice (port 8004) behind the Go API Gateway:
Flutter Creator Shell → API Gateway → Creator Service (Rust)
→ Distribution Service (Go)
→ Cloudflare R2 (Media Storage)
- Creator Service handles content CRUD, scheduling, media uploads, and podcast management
- Distribution Service orchestrates multi-platform publishing
- Cloudflare R2 stores media assets with CDN delivery
Content Lifecycle
Posts follow a state machine through their lifecycle:
Draft → Scheduled → Publishing → Published
→ Failed
Published → Archived
- Draft — Content is being authored, not yet scheduled
- Scheduled — Queued for future publishing at a specific time
- Publishing — Actively being distributed to target platforms
- Published — Successfully delivered to all target platforms
- Failed — Publishing failed on one or more platforms
- Archived — Removed from active display
Authentication
All Creator endpoints require a valid JWT Bearer token. Content creators need the content_creator role assigned through the Platform policy engine.
# Authenticate
TOKEN=$(curl -s -X POST https://dev.api.olympuscloud.ai/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "creator@example.com", "password": "..."}' | jq -r '.status.access_token')
# List posts
curl -s https://dev.api.olympuscloud.ai/v1/creator/posts \
-H "Authorization: Bearer $TOKEN" | jq .
Key Endpoints
| Method | Path | Description |
|---|---|---|
POST | /v1/creator/posts | Create a new post |
GET | /v1/creator/posts | List posts with filtering |
POST | /v1/creator/posts/:id/publish | Publish immediately |
POST | /v1/creator/posts/:id/schedule | Schedule for later |
POST | /v1/creator/media/upload | Initiate media upload |
POST | /v1/creator/episodes | Create podcast episode |
POST | /v1/creator/oauth/:platform/authorize | Connect social account |
Flutter Shells
Two Flutter shells serve the Creator platform:
| Shell | Purpose | Entrypoint |
|---|---|---|
| creator_admin | Content creation, publishing, analytics | main_creator.dart |
| creator_audience | Consumer-facing content consumption | main_creator.dart (different APP_EXPERIENCE) |
Related Documentation
- Content API — Content CRUD endpoints
- Social Publishing API — Multi-platform distribution
- Podcast API — Podcast management
- Audience API — Audience analytics
- Personas API — Creator persona management