# Genviral

## Docs

- [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
- [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.
- [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.
- [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
- [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`.
- [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
- [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 your selected pack images.
- [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.
- [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

## OpenAPI Specs

- [openapi](https://docs.genviral.io/api-reference/openapi.json)