VDClip

List the generated clips of a project (cursor-paginated). Each item carries clip_id, title, a short description/sample, highlight tags, duration, score (0-100 virality rank, higher = better), liked/disliked, status and rendering_status. Sort by score to pick the best clip. rendering_status=completed means the clip is rendered; get its signed MP4 URL via get_clip (render with render_clip first if needed).

list_clips

List scheduled/published posts on the calendar, cursor-paginated and with an optional date-range filter. Returns stats: the user's plan-level posting quota (day_used/day_limit, month_used/month_limit); derive remaining = limit - used before scheduling.

list_calendar

List the user's projects (cursor-paginated). Each item carries id, title, status, ai_type, aspect_ratio and duration. Pass id to get_project_status to poll progress, or to list_clips for its clips.

list_projects

List the connected social accounts. Each item is already shaped for publish_clip: copy account_id, platform, connection_id, user_name and user_handle straight into the accounts array. needs_reauth=true means the token expired and the account cannot publish until reconnected.

list_social_accounts

List the user's/team's saved templates (id, name, is_default) plus the built-in caption presets (kind: "preset"), organized so the user can pick a style. Use an item's id as create_project's preset_id (a saved template id or a preset id such as tiktok-viral).

list_templates

Processing status of a project. status is pending/processing/completed/failed; step is the pipeline stage index; error_code (when failed) is one of CONCURRENT_PROCESSING_LIMIT, EMAIL_NOT_VERIFIED, PROVIDER_DISABLED, PLAN_RESTRICTED, PROJECT_PROCESSING_ERROR, VIDEO_DURATION_TOO_SHORT, VIDEO_DURATION_TOO_LONG. Poll after create_project until completed, then list_clips.

get_project_status

POST the video to TikTok, Instagram, YouTube or Facebook — this is what "publish", "post it", "put it on TikTok" and "schedule for tomorrow" mean. Call list_social_accounts first for the account ids. is_scheduled=true requires scheduled_date (ISO 8601); otherwise it publishes immediately. Side effect: creates real post(s) on the platforms.

publish_clip

Signal feedback on a clip: "like" approves it for ranking; "dislike" rejects it. Neither action deletes the clip. Use when the user explicitly approves or rejects a clip.

rate_clip

EXPORT the finished video so the user can download or post it — this is what "export", "render", "download it" and "I want the file" mean. For ai_type=editor projects this is the billing point (call estimate_cost first); clipping/captions results were already charged at creation, so re-rendering them is free. Quality is plan-gated. method=browser (WebCodecs) or cloud. Returns render_id + version; poll get_clip for status and download_url.

render_clip

Prepare a direct upload of a browser-encoded (WebCodecs) render result: returns a presigned PUT URL + the exact headers to echo. PUT the render bytes, then call confirm_render_upload with the returned version. Only used for method=browser renders — cloud renders upload server-side.

request_render_upload

Update a scheduled post: new title, description and/or date. Partial PATCH: only the sent fields change. Use to move the date or fix the text before publishing.

reschedule_post

Schedule many clips across many accounts in one call. The backend distributes the posts over time by frequency, inside an 08:00-22:00 local window, and enforces the plan's daily/monthly limits. Requires a plan that allows scheduling. Returns post_ids plus a schedule_preview and skipped_clips (e.g. not_rendered). Side effect: creates scheduled posts.

schedule_clips_bulk

Create or update a project's public link. visibility=public exposes the finished clips; private restricts them. Use when enabling or changing sharing.

set_project_share

What THIS user can do: plan-gated features + catalogs (presets/templates/transitions/voices) + limits. Use up front to learn which tools/resources are enabled.

get_capabilities