Documentation

Pamba Docs

Everything you can do in Pamba — scripted content at scale, AI avatar videos, TikTok distribution, analytics, and an API to drive the whole thing from a Claude agent.

Projects

Where videos get made.

Content Hub

Ideas, scripts, patterns.

Avatars

Your AI cast.

Schedule

Auto-post to TikTok.

Platform

Dashboard

Your daily briefing. Built to answer 'what happened yesterday and what needs me today?' in under ten seconds.

KPI row

Four cards at the top: Yesterday's views (vs the day before), L7d views (vs prior 7 days), L7d engagement rate (vs prior 7 days), and Scheduled today with a remaining-vs-total counter (e.g. "8 — 3 left to post"). Each card shows a trend arrow and percentage change.

Yesterday strip

A horizontal scroll of every video you posted yesterday, each tile showing view count and a performance badge scored against that avatar's 30-day median: Strong, Good, Normal, Concern, Flop, or Early (not enough data yet). Click a tile to open the video on TikTok.

Needs attention

  • Failed posts (last 24h) — Oldest-first so the most urgent failures rise. One-click Retry or Dismiss on each row.
  • Idle active avatars — Active avatars that didn't post yesterday. Each row links to TikTok username setup or straight into creating a new project.

Today's queue

Every post scheduled for today (pending + already completed), sorted by time. Compact cards show avatar, title, TikTok handle, and scheduled time. Header shows "X of Y remaining" so you know how much of today's plan is still ahead.

Platform

Projects

Where videos get made. A Kanban board plus a chat-based creator for each project.

The board

Five columns: Concept Draft → Video Draft → Approved → Scheduled → Posted. Each card shows the avatar, title, first frame, and a snippet of the concept. Move cards through the pipeline with per-card actions — generate video, approve, schedule, mark as posted — plus download, archive, duplicate, and delete.

Creating a video

  • Pick an avatar — Every project starts with an avatar — the speaker persona your video uses.
  • Chat-based creator — Multi-turn conversation where you refine the concept, script, and shot list with AI.
  • Real-time preview — Video panel on the right shows generated clips as they render.
  • Pick your take — Each clip can have multiple generations — swap the one you prefer.
  • Text overlays — Add on-screen text, adjust placement, and regenerate variations.
  • Edited video upload — Have your own edit? Upload it to replace the rendered version.

List & calendar views

Prefer a table or calendar over the board? The list view gives you filter-by-avatar, search, and sortable columns. The calendar groups projects by scheduled date.

Projects are the center of Pamba. Ideas feed in, avatars power them, the schedule moves them out, analytics watches them land.

Platform

Content Hub

Alpha

Research, inspiration, and script generation. This is where video ideas come from.

Ideas

A research feed of TikTok videos, typically pulled from accounts you're tracking. Each idea shows thumbnail, views, likes, engagement rate, creator, and any pattern tags.

  • Bookmark or archive — Keep the ones you like, hide the ones you don't.
  • Generate scripts — One click turns an idea into 3–5 AI-drafted scripts.
  • Bulk actions — Select many ideas, generate scripts or tag patterns for the whole batch.
  • Branch an idea — Fork a variant with different angle or notes.

Scripts

Every generated script lives here. Edit, remix for variations, copy to clipboard, or use a script directly to start a new video project. Scripts can be attached to one or more avatars.

Patterns

A lifecycle board for formats and creative angles: Emerging → Working → Peaking → Declining. Tag your videos with patterns, watch what's trending, move them across the board as they rise and fall.

Content Strategy

A funnel view of your whole pipeline — Ideas → Scripts → Projects → Completed. Shows conversion rates and KPIs so you can see where content is stalling.

Tracked accounts

Add TikTok accounts you want to learn from. Pamba ingests their videos into the Ideas feed automatically, with engagement and views-per-day breakdowns per account.

Platform

Avatars

Your cast. The AI personas who appear in your videos.

  • Create from image or AI — Upload a reference photo or generate one. Pick gender, accent, style.
  • Voice selection — Choose from a voice library or use a custom voice sample.
  • Appearance & bio — Tune base and adaptive descriptions so the avatar looks consistent across videos.
  • Status toggle — Training / Active / Archived — only Active avatars show up in the project creator.
  • Tags & TikTok usernames — Group avatars by niche; link to the TikTok accounts they post to.
  • Starting frames library — Build a library of reference images to constrain avatar appearance in generation.
  • Bulk first frames — Generate frames for many avatars × TikTok reference videos in one job.
  • Collection view — Browse the community pool of pre-generated avatars you can claim.
One avatar can span many projects. Swap avatars across videos without rewriting scripts.

Platform

Schedule

Alpha

When and where your videos go live. Auto-post to TikTok through managed posting infrastructure.

  • Calendar + list views — See what's queued by day, or scroll a flat list with status tabs.
  • Status lifecycle — Pending → In Progress → Completed (or Failed / Cancelled).
  • Reschedule & edit — Change time, caption, privacy, or video URL before it posts.
  • Retry failed posts — Something broke? Retry in one click. Or dismiss it for good.
  • Bulk schedule — Approve many projects, assign dates, and queue them all at once.
  • Timezone aware — Scheduling respects your local TZ so you don't post at 3am by accident.

Posts are delivered through managed TikTok posting infrastructure. Each posting slot can serve up to 3 TikTok accounts.

Platform

Analytics

Alpha

How your content is doing. Per account, per video, over any date range.

  • KPI strip — Views, likes, comments, shares, engagement — with period-over-period trend arrows.
  • Date range + comparison — 7 / 30 / 365 days out of the box, with auto-comparison to the previous period.
  • Account filter pills — Scope to one account or toggle groups to compare.
  • Views trend chart — Daily views over time — spot spikes and cliffs fast.
  • Flop detection — Pamba surfaces videos that landed way below your median. Know when something tanked.
  • Top performers — Your best videos of the period, ranked.
  • Account health — Posting consistency, average views, growth trend per account.
  • Yesterday snapshot — Quick AM check-in: what shipped yesterday and how it did.

Platform

Warming

Alpha

Mature new TikTok accounts before you post on them. Prevents shadow-banning and builds an algorithm signal.

  • Session queue — List of warming sessions with status: pending, in progress, completed, failed.
  • Per-avatar config — Set daily minutes, session count, and search terms for each avatar's account.
  • Session status — Review recent warming sessions by account, status, and timing.
  • Cancel & retry — Stop pending sessions, retry failed ones.
  • Safety caps — Max 60 min/day, max 5 sessions/day to stay within TikTok norms.

Platform

Strategy

A living playbook tuned to your goals — formats to use, cadence, platform mix.

  • TLDR table — At-a-glance: accounts, avatars, cadence, content types, platforms.
  • Goal breakdown — The campaign objective written out so everyone's aligned.
  • Account setup guide — What goes where, how often, across TikTok / IG / X.
  • Recommended formats — Links to the specific formats that work for your niche: App Demo, Founder-led, Trends, AI Storytelling, etc.
  • Posting strategy — Optimal times, frequency guidelines, pro tips on consistency and batch planning.

Developers

API & Claude agent

Drive Pamba from your own agent with workspace-scoped API keys, route-accurate examples, and a public customer API surface.

The full public API reference now lives at pamba.app/api. It includes endpoint auth, request structures, response structures, credit usage, and examples for customer automation.

Grab your API key from your workspace settings (open the workspace switcher in the top nav, then click Settings), then give your agent the matching markdown guide below.

Once your agent has it, a prompt like What can you do with Pamba? should produce a concrete menu of customer workflows, not stale endpoint guesses.

Authentication

Base URL https://api.pamba.app
Agent auth X-API-Key
JWT callers must include X-Workspace-Id on workspace-scoped routes. API-key callers do not; the key already carries the workspace.

Credit usage

AI clip generationPOST /projects/{projectId}/generate-clip-videos; automated project creation; automation resume/restart

50 credits x generated video seconds. Pamba reserves credits for requested duration, then charges successful generated clip seconds.

Project creation, ideas/scripts, TikTok research and analytics, avatar/frame management, scheduling, warming, rendering existing edits, and editor-state saves are not separately credit-metered in the public API today. Insufficient direct-charge requests return 402 Payment Required with remaining_credits and required_credits. Use GET /user to inspect subscription state and credit totals/usage.

Public customer API surface

This is a compact capability map. Use the public API reference for the complete endpoint list, request bodies, response shapes, and examples.

Ideas and scripts

GET/ideas

List ideas with pagination, search, performance filters, and archived state.

POST/ideas

Bulk-create ideas from titles, notes, and TikTok URLs.

POST/ideas/scripts/remix

Generate a script remix from an idea.

POST/ideas/scripts/{id}/create-video-project

Turn a script into a video project.

Research and analytics

POST/tiktok/tracked-accounts

Track TikTok usernames for research.

GET/tiktok/tracked-accounts/videos

List analyzed tracked videos with sorting and filters.

GET/tiktok/tracked-accounts/{username}/metrics

Read aggregate metrics for one account.

GET/tiktok/analytics/dashboard

Fetch dashboard trends, top videos, and scope comparisons.

Avatars and frames

GET/avatars

List avatars by status or tag.

PUT/avatars/projects/{projectId}/selected-avatar

Update selected-avatar tags, TikTok usernames, status, and warming config.

GET/avatars/projects/{projectId}/selected-avatar/starting-frames

List scenes for an avatar project.

PATCH/avatars/starting-frames/{frameId}

Update frame active state, camera style, or tags.

Projects and generation

POST/projects

Bulk-create projects, including fully automated videos.

POST/projects/create

Create one blank project for an avatar.

POST/projects/{projectId}/generate-clip-videos

Generate selected clip indexes.

POST/projects/{projectId}/schedule

Schedule a project to TikTok.

Scheduling and warming

GET/devices/tiktok/posts/scheduled

List scheduled posts by page or date range.

PUT/devices/tiktok/posts/{postId}

Update, reschedule, or dismiss a post.

POST/devices/tiktok/posts/{postId}/retry

Retry a failed post.

GET/devices/tiktok/warming/sessions

List warming sessions for the workspace.

What your agent can do

  • Track TikTok accounts and mine analyzed videos
  • Add ideas in bulk and remix scripts
  • Attach avatars to ideas or scripts
  • Create fully automated project batches
  • Generate clips and select takes
  • Save editor state or render finished videos
  • Schedule, reschedule, cancel, and retry posts
  • Configure avatar warming and inspect sessions
  • Create avatars from reference images
  • Manage avatar starting-frame libraries
  • Pull analytics dashboards and account metrics
Use pamba.app/api as the supported customer API surface for new integrations. Use GET /user to inspect subscription state and credit totals/usage.

Missing something? Alpha customers get it added fast — email us at eric@pamba.app.