--- title: Colossyan API Integration on Truto slug: colossyan category: Video canonical: "https://truto.one/integrations/detail/colossyan/" --- # Colossyan API Integration on Truto **Category:** Video **Status:** Generally available ## MCP-ready AI tools Truto exposes 10 tools for Colossyan that AI agents can call directly. - **list_all_colossyan_assets_actors** — List avatars available in your Colossyan workspace. Returns each avatar with id, name, display_name, preview_url, version, type, gender, default_voice, views, features, and other attributes. - **create_a_colossyan_assets_actor** — Create a new avatar in Colossyan. Returns: name. - **list_all_colossyan_assets_voices** — List voices available to the workspace in Colossyan. Returns each voice record with id and voice-specific attributes. - **create_a_colossyan_video_generation_jobs_template_job** — Create a Colossyan video generation job from a saved template. Returns: id, videoId. Required: templateJobId and the template-specific generation payload. - **create_a_colossyan_video_generation_job** — Create a new Colossyan video generation job. Returns the queued job identifier and provisioned video id. Required: a JSON request body shaped by Colossyan's VideoGenerationJob schema. - **get_single_colossyan_video_generation_job_by_id** — Get the status and progress of a Colossyan video generation job by id. Returns: status, videoId, progress, maximumProgress. Required: id. - **delete_a_colossyan_video_generation_job_by_id** — Delete a Colossyan video generation job by id and stop any ongoing processing. Returns an empty 204 response on success. Required: id. - **get_single_colossyan_generated_video_by_id** — Get a generated video from Colossyan by id. Returns: id, jobId, publicUrl, thumbnailUrl, name, createdAt, videoSizeBytes, videoDurationSeconds. Required: id. - **delete_a_colossyan_generated_video_by_id** — Delete a generated video from Colossyan by id. Returns the deleted video record including id, publicUrl, thumbnailUrl, createdAt, name, jobId, videoSizeBytes, and videoDurationSeconds. Required: id. - **create_a_colossyan_knowledge_to_draft_generate_draft** — Generate a draft in Colossyan from structured textual data. Returns: url. Requires a request body. Required: summary. ## How it works 1. **Link your customer's Colossyan account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Colossyan.** The Proxy API is a 1-to-1 mapping of the Colossyan API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Embed AI Video Creation Inside Knowledge Platforms** — Wikis, LMS, and documentation tools can let users transform written content into presenter-led videos without leaving the app. This turns static articles into engaging training assets and increases content consumption rates. - **Scale Personalized Video Outreach** — Sales engagement and marketing automation platforms can loop through prospect lists and generate hundreds of variable-injected videos from a single template. This unlocks a high-conversion channel that would otherwise require manual production. - **Automate Training Content for L&D Teams** — HR tech and corporate learning platforms can offer one-click video generation from policies, SOPs, or onboarding documents. This eliminates the studio, actor, and editing costs L&D teams currently pay to produce compliance content. - **Auto-Populate Media Libraries with Rendered Videos** — Content management and course authoring tools can pull finished video URLs, thumbnails, duration, and file size directly into their media library. Users get a fully synced asset catalog without manual uploads. - **Dynamic Video Responses in Support Workflows** — Helpdesk and customer education platforms can generate short avatar-led explainer videos on demand from ticket content or macro text. Support teams resolve complex issues faster with visual walkthroughs instead of long text replies. ## What you can build - **Native Avatar and Voice Picker** — Render Colossyan's actors and voices inside your own UI so users can browse and select presenters without leaving your product. - **Article-to-Video Button** — Convert any long-form text into a Colossyan draft script using the knowledge-to-draft endpoint and kick off video generation in one click. - **Template-Based Bulk Video Generation** — Reference a pre-designed Colossyan template and inject per-recipient variables to produce personalized videos at scale from your workflow engine. - **Async Render Status Dashboard** — Track in-progress video generation jobs by polling job status and surface completion state, thumbnails, and public URLs inside your app. - **Auto-Synced Video Media Library** — Pull rendered video URLs, thumbnails, duration, and file size into your platform's media library the moment a job completes. - **Custom Avatar Provisioning** — Let end users create branded actor assets in Colossyan directly from your product's settings, keeping avatar management in-app. ## FAQs ### How do end users connect their Colossyan account through Truto? Colossyan uses API key authentication. Truto handles the credential capture, secure storage, and injection into every downstream request, so your users only paste their key once and your backend never touches it. ### How does video generation work given it's asynchronous? You create a job with create_a_colossyan_video_generation_job (or the template variant), then poll get_single_colossyan_video_generation_job_by_id for status. Once complete, fetch the rendered asset via get_single_colossyan_generated_video_by_id to retrieve the public URL, thumbnail, duration, and file size. ### Can we generate videos from templates with dynamic variables? Yes. create_a_colossyan_video_generation_jobs_template_job accepts a template ID plus a payload of variables, which is the recommended path for high-volume personalized video use cases like sales outreach. ### Can we let users pick avatars and voices from within our UI? Yes. list_all_colossyan_assets_actors and list_all_colossyan_assets_voices return the full catalog of available presenters and voice options, which you can render as native selectors in your own product. ### Can we convert existing documents into video scripts? Yes. create_a_colossyan_knowledge_to_draft_generate_draft accepts textual content and returns an optimized draft that can then be passed into a generation job, making it ideal for article-to-video workflows. ### Can we clean up videos and jobs created through the integration? Yes. delete_a_colossyan_video_generation_job_by_id removes generation jobs and delete_a_colossyan_generated_video_by_id removes rendered videos, letting you enforce retention policies or user-initiated deletions from your app.