# Genviral

- [Genviral Partner API](https://docs.genviral.io/api-reference/introduction.md): REST API for posting, scheduling, slideshows, Studio AI, analytics, and automation across your connected social accounts.
- [llms.txt](https://docs.genviral.io/api-reference/llms-txt.md): Machine-readable doc index for AI agents and coding tools.
- [Response Pattern](https://docs.genviral.io/api-reference/response.md): Consistent JSON response envelope and error handling for the Genviral social media posting API. Every endpoint - TikTok, Instagram, YouTube, Pinterest, LinkedIn, Facebook - returns the same typed structure for easy parsing by AI agents and automation scripts.
- [Data Structures](https://docs.genviral.io/api-reference/data-structures.md): Canonical data models for accounts, capabilities, posts, slideshows, analytics, and more returned by the Genviral social media API.
- [Folders](https://docs.genviral.io/api-reference/folders.md): Organize partner-scoped files and slideshows in nested folders
- [Studio AI](https://docs.genviral.io/api-reference/studio-ai.md): Generate AI Studio images and videos through Partner API with model parity, credits parity, and canonical video polling.
- [Slideshows – AI Slideshow Generation API for TikTok, Instagram & More](https://docs.genviral.io/api-reference/slideshows.md): Generate AI-powered slideshows for TikTok photo carousels, Instagram carousels, Pinterest pins, and more. Create, edit, render, and post slideshows programmatically - perfect for OpenClaw agents and automated content pipelines.
- [Slideshow Packs – Reusable Image Collections for Automated Content](https://docs.genviral.io/api-reference/slideshow-packs.md): Manage reusable image packs for AI slideshow generation. Upload images, organize collections, and reference them across TikTok slideshows, Instagram carousels, and automated posting workflows. Built for OpenClaw agents and programmatic content creation.
- [Slideshow Templates – Reusable Blueprints for Automated Slideshow Creation](https://docs.genviral.io/api-reference/slideshow-templates.md): Create and manage reusable slideshow templates for consistent TikTok photo carousels, Instagram carousels, and cross-platform content. Perfect for OpenClaw agents and AI automation workflows that need repeatable, brand-consistent slideshow formats.
- [Get Accounts](https://docs.genviral.io/api-reference/get-accounts.md): List connected social accounts and discover per-account posting capabilities, media limits, caption limits, and settings schemas for the Genviral social media API.
- [Get Subscription](https://docs.genviral.io/api-reference/get-subscription.md): Return subscription status, credits, and renewal dates for the authenticated key scope
- [List Workspaces](https://docs.genviral.io/api-reference/list-workspaces.md): List the tenancies this credential is allowed to work in
- [Get Analytics Summary](https://docs.genviral.io/api-reference/get-analytics-summary.md): Fetch social media analytics for TikTok, Instagram, and YouTube - including views, likes, comments, shares, engagement rates, and posting streaks. Feed performance data back to your OpenClaw agent for strategy optimization.
- [List Analytics Posts](https://docs.genviral.io/api-reference/list-analytics-posts.md): Fetch paginated post-level analytics across tracked accounts
- [Get Best Posting Times](https://docs.genviral.io/api-reference/get-best-posting-times.md): Rank the weekdays and hours when your own published posts performed best, from your Genviral analytics.
- [List Analytics Targets](https://docs.genviral.io/api-reference/manage-analytics-targets.md): List tracked analytics accounts in the authenticated key scope
- [Create Analytics Target](https://docs.genviral.io/api-reference/create-analytics-target.md): Add a tracked analytics account
- [Get Analytics Target](https://docs.genviral.io/api-reference/manage-analytics-target.md): Fetch detail + summary for one tracked analytics target
- [Update Analytics Target](https://docs.genviral.io/api-reference/update-analytics-target.md): Update display/refresh/favorite settings for one target
- [Delete Analytics Target](https://docs.genviral.io/api-reference/delete-analytics-target.md): Delete one tracked analytics target
- [Refresh Analytics Target](https://docs.genviral.io/api-reference/refresh-analytics-target.md): Trigger an analytics refresh for a target and return refresh metadata
- [Get Analytics Refresh](https://docs.genviral.io/api-reference/get-analytics-refresh.md): Check refresh status for an analytics refresh request
- [Get Analytics Workspace Suggestions](https://docs.genviral.io/api-reference/get-analytics-workspace-suggestions.md): List other workspace/personal analytics scopes with available tracked accounts
- [Create Post](https://docs.genviral.io/api-reference/create-post.md): Schedule or publish text-only, video, or slideshow posts to connected accounts.
- [Get Suggested Post Slot](https://docs.genviral.io/api-reference/get-suggested-post-slot.md): Suggest the next free time to post to one or more accounts, based on the posting times set for them in Genviral.
- [List Posts](https://docs.genviral.io/api-reference/list-posts.md): Fetch recent Partner API posts with delivery status and summary. Track your automated posting pipeline across supported platforms.
- [Get Post](https://docs.genviral.io/api-reference/get-post.md): Retrieve details for a specific post
- [Update Post](https://docs.genviral.io/api-reference/update-post.md): Update a scheduled or pending post
- [Delete Posts](https://docs.genviral.io/api-reference/delete-post.md): Delete one or many posts with a single request
- [Retry Post](https://docs.genviral.io/api-reference/retry-posts.md): Retry failed or partial posts
- [Upload File](https://docs.genviral.io/api-reference/upload-file.md): Upload images and videos to Genviral CDN for use in TikTok slideshows, Instagram carousels, YouTube Shorts, Pinterest pins, LinkedIn posts, and Facebook content. Supports programmatic uploads from OpenClaw agents and automation pipelines.
- [Start Multipart Upload](https://docs.genviral.io/api-reference/start-multipart-upload.md): Upload videos up to 500 MB in resumable parts, then finalize them into the Genviral Media Library.
- [Complete Multipart Upload](https://docs.genviral.io/api-reference/complete-multipart-upload.md): Assemble uploaded parts, verify the media, and create the CDN-backed Media Library record.
- [Abort Multipart Upload](https://docs.genviral.io/api-reference/abort-multipart-upload.md): Discard an unfinished multipart upload and its uploaded parts.
- [List Files](https://docs.genviral.io/api-reference/list-files.md): List partner files in the authenticated key scope
- [List Folders](https://docs.genviral.io/api-reference/list-folders.md): List folders by media type and parent level in the authenticated key scope
- [Create Folder](https://docs.genviral.io/api-reference/create-folder.md): Create a folder in the authenticated key scope
- [Get Folder](https://docs.genviral.io/api-reference/get-folder.md): Retrieve one folder in the authenticated key scope
- [Move Folder](https://docs.genviral.io/api-reference/move-folder.md): Move a folder to a new parent or to the root level
- [Delete Folder](https://docs.genviral.io/api-reference/delete-folder.md): Delete a folder in the authenticated key scope
- [List Folder Ancestors](https://docs.genviral.io/api-reference/list-folder-ancestors.md): Get breadcrumb ancestors for a folder
- [List Folder Items](https://docs.genviral.io/api-reference/list-folder-items.md): List files or slideshows contained in a folder
- [Add Folder Items](https://docs.genviral.io/api-reference/add-folder-items.md): Add files or slideshows to a folder
- [Remove Folder Items](https://docs.genviral.io/api-reference/remove-folder-items.md): Remove files or slideshows from a folder
- [List Influencers](https://docs.genviral.io/api-reference/list-influencers.md): List influencers (consistent characters) and their reference images
- [Get Influencer](https://docs.genviral.io/api-reference/get-influencer.md): Read one influencer (consistent character) and its reference images
- [Get Studio Models](https://docs.genviral.io/api-reference/get-studio-models.md): List Studio image/video models with normalized capabilities, params, and credit notes.
- [Generate Studio Image](https://docs.genviral.io/api-reference/generate-studio-image.md): Generate an AI Studio image with normalized params and optional model-specific raw passthrough.
- [Generate Studio Video](https://docs.genviral.io/api-reference/generate-studio-video.md): Start async AI Studio video generation and return canonical `video_id` for polling.
- [Get Studio Video](https://docs.genviral.io/api-reference/get-studio-video.md): Poll canonical video generation status by `video_id`.
- [Prepare a verified Studio asset](https://docs.genviral.io/api-reference/materialize-studio-asset.md)
- [Create a character-swap batch](https://docs.genviral.io/api-reference/create-character-swap-batch.md)
- [Browse Studio templates](https://docs.genviral.io/api-reference/list-studio-templates.md)
- [Get a Studio template recipe](https://docs.genviral.io/api-reference/get-studio-template.md)
- [List saved Studio creations](https://docs.genviral.io/api-reference/list-studio-creations.md)
- [Get a saved Studio creation](https://docs.genviral.io/api-reference/get-studio-creation.md)
- [Browse Studio products](https://docs.genviral.io/api-reference/list-studio-products.md)
- [Browse trained character profiles](https://docs.genviral.io/api-reference/list-studio-character-profiles.md)
- [Delete a Studio creation](https://docs.genviral.io/api-reference/delete-studio-creation.md)
- [Favorite a character-swap template](https://docs.genviral.io/api-reference/favorite-studio-template.md)
- [Translate a verified video](https://docs.genviral.io/api-reference/translate-studio-video.md)
- [Start Slideshow Generation](https://docs.genviral.io/api-reference/start-slideshow-generation.md): Start async slideshow generation from your own slide copy, or recreate a Viral Library post.
- [Generate Slideshow](https://docs.genviral.io/api-reference/generate-slideshow.md): Generate AI-powered slideshows for TikTok photo carousels, Instagram carousels, Pinterest pins, and more. Supports AI generation from prompts, manual slide configuration, and mixed mode. The core content creation endpoint for OpenClaw agents.
- [List Slideshows](https://docs.genviral.io/api-reference/list-slideshows.md): List slideshow summaries in authenticated key scope
- [Get Slideshow](https://docs.genviral.io/api-reference/get-slideshow.md): Retrieve a full slideshow payload
- [Get Slideshow Edit State](https://docs.genviral.io/api-reference/get-slideshow-edit-state.md): Read the canonical editable snapshot and revision.
- [Apply Slideshow Edits](https://docs.genviral.io/api-reference/apply-slideshow-edits.md): Save revision-checked edits with a durable idempotency receipt.
- [Update Slideshow](https://docs.genviral.io/api-reference/update-slideshow.md): Update slideshow metadata, settings, product link, or full slide content
- [Delete Slideshow](https://docs.genviral.io/api-reference/delete-slideshow.md): Delete a slideshow in authenticated key scope
- [Render Slideshow](https://docs.genviral.io/api-reference/render-slideshow.md): Render slideshow slides into final images ready for posting to media-capable accounts. Produces optimized slide assets with text overlays that your OpenClaw agent can immediately publish via the Create Post endpoint.
- [Duplicate Slideshow](https://docs.genviral.io/api-reference/duplicate-slideshow.md): Create a draft copy of an existing slideshow
- [Regenerate Slide](https://docs.genviral.io/api-reference/regenerate-slide.md): Regenerate text for one slide while preserving layout
- [Preview TikTok Slideshow Copy](https://docs.genviral.io/api-reference/copy-tiktok-preview.md): Fetch TikTok slideshow metadata + image URLs before importing into an editable Genviral slideshow.
- [Import TikTok Slideshow Copy](https://docs.genviral.io/api-reference/copy-tiktok-import.md): Import a TikTok slideshow into an editable Genviral draft with OCR-mapped text overlays and automatic Pinterest or selected pack backgrounds.
- [Create a manual slideshow](https://docs.genviral.io/api-reference/create-manual-slideshow.md)
- [Export a slideshow](https://docs.genviral.io/api-reference/export-slideshow.md)
- [Generate slide text variations](https://docs.genviral.io/api-reference/generate-slide-text-variations.md)
- [Import a slideshow image](https://docs.genviral.io/api-reference/import-slideshow-image.md)
- [Create Editor Project](https://docs.genviral.io/api-reference/create-editor-project.md): Start a video editing project from videos you uploaded, ready for cutting.
- [List Editor Projects](https://docs.genviral.io/api-reference/list-editor-projects.md): List video editor projects in the authenticated scope, newest edit first.
- [Get Editor Project](https://docs.genviral.io/api-reference/get-editor-project.md): Read a video editor project: assets, timeline clips, text clips, and the latest render.
- [Apply Editor Ops](https://docs.genviral.io/api-reference/apply-editor-ops.md): Cut, rename or style text in a video project with an atomic batch of edit operations.
- [Add Editor Files](https://docs.genviral.io/api-reference/add-editor-files.md): Append uploaded videos to the end of an existing video project.
- [Add Editor Captions](https://docs.genviral.io/api-reference/add-editor-captions.md): Transcribe the cut and add timed captions to a video project.
- [Post Editor Message](https://docs.genviral.io/api-reference/post-editor-message.md): Show a short message to the user watching a video project in the Genviral editor.
- [Get Editor Transcript](https://docs.genviral.io/api-reference/get-editor-transcript.md): Word timings and silences for the project videos, in source milliseconds.
- [Render Editor Project](https://docs.genviral.io/api-reference/render-editor-project.md): Start rendering the current cut of a project to an MP4.
- [Get Editor Render](https://docs.genviral.io/api-reference/get-editor-render.md): Status of the latest render of a project.
- [Add editor media](https://docs.genviral.io/api-reference/add-editor-assets.md)
- [Paste scoped editor clips](https://docs.genviral.io/api-reference/paste-editor-clips.md)
- [Import a reviewed slideshow](https://docs.genviral.io/api-reference/import-editor-slideshow.md)
- [Import reviewed remix clips](https://docs.genviral.io/api-reference/import-editor-remix.md)
- [Review editor version scheduling](https://docs.genviral.io/api-reference/prepare-editor-schedule.md)
- [Confirm editor version scheduling](https://docs.genviral.io/api-reference/commit-editor-schedule.md)
- [Read editor scheduling status](https://docs.genviral.io/api-reference/get-editor-schedule-status.md)
- [Read editor batch status](https://docs.genviral.io/api-reference/get-editor-batch-status.md)
- [Dismiss a failed batch item](https://docs.genviral.io/api-reference/dismiss-editor-batch-item.md)
- [Search Reddit communities](https://docs.genviral.io/api-reference/search-editor-reddit-communities.md)
- [Read Reddit community settings](https://docs.genviral.io/api-reference/get-editor-reddit-restrictions.md)
- [Search Viral Library](https://docs.genviral.io/api-reference/search-viral-library.md): Search Genviral's curated corpus of organic viral posts by idea, category, platform, account, or publish date
- [Get Viral Library Post](https://docs.genviral.io/api-reference/get-viral-library-post.md): Read one viral library post by ID, including the slide texts a search result omits
- [Get Viral Library Transcript](https://docs.genviral.io/api-reference/get-viral-library-transcript.md): Read the stored spoken transcript for one Viral Library post
- [Get Trend Brief](https://docs.genviral.io/api-reference/get-trend-brief.md): Generate a one-call TikTok trend brief for a keyword with top hashtags, sounds, creators, posting windows, hook angles, and sample videos.
- [Search Reddit Posts](https://docs.genviral.io/api-reference/search-reddit-posts.md): Discover public Reddit posts about a topic and get back their canonical permalinks, titles, subreddits, authors, and self text
- [Read Reddit Threads](https://docs.genviral.io/api-reference/read-reddit-threads.md): Read a bounded sample of comments for up to 10 canonical Reddit post links, with a coverage block that states what was sampled
- [List Packs](https://docs.genviral.io/api-reference/list-packs.md): List visible packs with pagination and optional public-pack inclusion
- [Create Pack](https://docs.genviral.io/api-reference/create-pack.md): Create a reusable image pack
- [Get Pack](https://docs.genviral.io/api-reference/get-pack.md): Retrieve pack metadata and a bounded ordered image page
- [Update Pack](https://docs.genviral.io/api-reference/update-pack.md): Update pack name and/or visibility
- [Delete Pack](https://docs.genviral.io/api-reference/delete-pack.md): Delete a mutable pack in key scope
- [Add Pack Image](https://docs.genviral.io/api-reference/add-pack-image.md): Add one image URL reference to a pack
- [Delete Pack Image](https://docs.genviral.io/api-reference/delete-pack-image.md): Delete one image from a pack
- [List Templates](https://docs.genviral.io/api-reference/list-templates.md): List templates visible to authenticated key scope
- [Create Template](https://docs.genviral.io/api-reference/create-template.md): Create a reusable slideshow template
- [Get Template](https://docs.genviral.io/api-reference/get-template.md): Retrieve one template in scope
- [Update Template](https://docs.genviral.io/api-reference/update-template.md): Update mutable template fields
- [Delete Template](https://docs.genviral.io/api-reference/delete-template.md): Delete a mutable template
- [Create Template From Slideshow](https://docs.genviral.io/api-reference/create-template-from-slideshow.md): Convert an existing slideshow into a reusable template
- [List music tracks](https://docs.genviral.io/api-reference/list-music-tracks.md)
- [Add a music track](https://docs.genviral.io/api-reference/add-music-track.md)
- [Rename a music track](https://docs.genviral.io/api-reference/update-music-track.md)
- [Delete a music track](https://docs.genviral.io/api-reference/delete-music-track.md)
- [Import music](https://docs.genviral.io/api-reference/import-music.md)
- [Preview a remix source](https://docs.genviral.io/api-reference/preview-remix-source.md)
- [Discover remix sources](https://docs.genviral.io/api-reference/discover-remix-sources.md)
- [Create a remix project](https://docs.genviral.io/api-reference/create-remix-project.md)
- [List remix clips](https://docs.genviral.io/api-reference/list-remix-clips.md)
- [Import remix clips](https://docs.genviral.io/api-reference/import-remix-clips.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.