Content Workflow
Understanding the post lifecycle in Vibescaling
Post lifecycle
Every post moves through these statuses:
- Draft — Created via dashboard or API. Can be edited freely.
- Scheduled — Assigned a publish date/time and TikTok account. Will publish automatically.
- Posted — Successfully published to TikTok.
- Archived — Removed from active view. Can be unarchived.
Creating posts
Via Dashboard
Click New Post in the Library. Fill in:
- Title (required)
- Caption and Hashtags (optional)
- TikTok Account to publish to
- Slides — drag to reorder
Via API
curl -X POST https://admin.vibescaling.org/api/v1/posts \
-H "Authorization: Bearer vs_your_api_key" \
-H "Content-Type: application/json" \
-d '{"title": "My Post", "caption": "Check this out"}'Then upload slides:
curl -X POST https://admin.vibescaling.org/api/v1/posts/{id}/assets \
-H "Authorization: Bearer vs_your_api_key" \
-H "Content-Type: application/json" \
-d '{"filename": "slide1.png", "content_type": "image/png"}'Upload the file to the returned upload_url.
Publishing
Publish now
From a draft post, click Publish Now to post immediately to TikTok.
Schedule
Click Schedule, pick a date and time (minimum 5 minutes from now), and select the TikTok account. The post will publish automatically via a background job.
Via API
Schedule a post:
curl -X PATCH https://admin.vibescaling.org/api/v1/posts/{id} \
-H "Authorization: Bearer vs_your_api_key" \
-H "Content-Type: application/json" \
-d '{"status": "scheduled", "scheduled_at": "2026-03-15T14:00:00Z", "tiktok_account_id": "uuid"}'Or publish immediately:
curl -X POST https://admin.vibescaling.org/api/v1/posts/{id}/publish \
-H "Authorization: Bearer vs_your_api_key" \
-H "Content-Type: application/json" \
-d '{"tiktok_account_id": "uuid"}'