Vidreno

Confirm you addressed the current change request on your own film. Uses the exact reviewed_at from get_film_workflow; cannot reinstate a removed film.

Add an episode to a season, numbered after the last one, as a draft with no video. Title, synopsis, runtime and a buy/rent price for this episode alone are optional. Up to 200 per season. Then start_film_upload with asset: episode and the returned episode id for its video, and publish_episode once the video is ready and the season is published.

Add a credit (role + name) to a film's credit list, optionally linking it to a Vidreno filmmaker by username (they get a request to accept) or inviting the person by email (the invite is sent straight away; at most 60 credits per film, invites are rate-limited per day). Returns the full credit list with credit_ids.

Add a role the project is looking for (the Studio's Roles tab): the role name, how many people, what it involves and the pay (paid with an amount, currency and per day / flat / per hour; expenses only; unpaid; deferred / profit share). Up to 20 roles per project. Returns the project with its roles and their ids.

Add a season to a series (a film created with kind: series), numbered after the last one, as a draft. Title and synopsis are optional ("Season N" otherwise); a buy/rent price here sells the whole season once it is published with a playable episode. Up to 50 seasons. The age rating and content descriptors belong to the whole series (create_film / update_film), not to a season or episode. Returns the film (with every season) and the new season's id for add_episode.

Apply to an open role as the user, with their filmmaker profile as the application (the owner sees the public profile card), an optional note and up to 3 links. The apply form's rules apply unchanged: a creator account with a public filmmaker profile, display name and at least one role; one application per role; not the user's own project; up to 20 applications a day. The owner is e-mailed.

Archive a bonus item, preserving existing customers' promised access.

Cancel a pending protection change only while Studio allows it.

Close a live project: its page stays readable with a "no longer looking for people" notice, it leaves Projects, Jobs and the sitemaps, every open role closes and pending applicants are told by e-mail. Always confirm with the user first (name the project) and only then call with confirm set to true.

Turn a film's plain director and cast text lines into credit rows (Director for the director line, Actor for each comma-separated cast name), appended after the existing credits, and clear the lines — the film editor's convert button. Nothing is linked or invited; use update_film_credit afterwards. Returns the full credit list.

Create a new draft film from a title (optionally with its age_rating and content_descriptors), exactly as the Studio's add-film dialog does. The draft starts as Buy or rent with no prices, no poster and no files, and is not public until publish_film. Returns the film's id, editor link and publish checklist (the same shape as get_film), so the next steps are update_film (details, access: free or paid, prices), start_film_upload (main film), the poster in the film editor, then publish_film.

Create a draft bonus item. Use a file handoff for PDF/image assets; video files use start_film_master_upload. Scope it to the film, a season or an episode.

Create a new draft project exactly as the Studio's New project does: a title (optional) and whether it is public or private (invite only). The draft is not listed until publish_project. Refused with the Studio's own message when the user's filmmaker profile is not ready (a creator account with a public filmmaker profile, display name and at least one role) or the user already has the maximum number of live projects. Returns the project (same shape as get_project): next are update_project for the details, add_project_role for each role, then publish_project.

Delete a discussion post you are permitted to delete as creator. Deleting a parent also removes its replies.

Permanently delete a hosted video and its file. Irreversible: always confirm with the user first (name the video) and only then call with confirm set to true.

Return a signed-in owner download link for an uploaded or generated subtitle track. The user must open it in their authenticated browser.

Replace a bounded range of automatic subtitle cues. Reads the full track server-side and validates timing before saving; does not overwrite concurrent edits. Set draft=true to save without publishing.

The connected creator's account overview: which product it is set up for (creator_mode: On Demand for films, or Video Hosting for hosted videos; a preference that shapes what to suggest first, not a restriction on the tools), plan, hosted-video storage used versus the plan limit, how many hosted videos and films they have, and their public filmmaker profile link when the profile is public.

Read creator mode, marketing email preference and bandwidth usage. Sign-in credentials are never editable through MCP.

How the user's videos are doing: totals (videos, views, storage), the most viewed videos, the newest uploads and a daily views series for the last N days.

Read your account's hosted-player accent colour and branding banner entitlement.

What the user's Payouts page shows, read-only: lifetime and this month's earnings split into film sales and ad earnings, the balance (available to cash out, maturing inside the hold window, paid out, in flight), the payout minimum and hold period, the saved payout method in masked form, whether ad earnings are live for this account or still coming soon (with the current ad terms: what advertisers pay per 1,000 views and the share the user keeps after payment-processing fees), a per-film breakdown (sales, refunds, gross, net earnings) and the 5 most recent payouts. Amounts are in cents with a display string. Read-only: to cash out or change the payout method the user opens https://vidreno.com/payouts. Use list_payouts for the full payout history and list_film_sales for individual orders.

Build the HTML embed snippet for a video with the chosen player options (autoplay, muted, loop, controls, corner radius, fullscreen, responsive or fixed size). The snippet keeps the video's own aspect ratio (16:9 when its size is unknown). Also returns the bare iframe URL, the player and share links, and the direct HLS stream link (hls_url, for third-party players and channel tools that take a .m3u8 rather than an iframe) when available, else hls_status and hls_reason explaining what is missing. In urls, share (/player/) is the public link to give out and embed_iframe the embed URL; manage (/video/) is the owner's own editing page, sign-in required, and anyone else opening it is sent to the player page — never hand it out as a share link.

Check a file handoff created for your account. Reports whether its destination has changed since the handoff; never returns stored object keys.

Full details of one film: status (draft/published), how it is released (free to watch or buy/rent) and its prices, play count, metadata, main film and trailer state, credits (with credit_ids), the publish checklist and its public page link. Films cannot be embedded.

Read original language codes, No dialogue, detection progress and episode inheritance. Detection is separate from video encoding.

Read upload, encode, protection and subtitle status separately. Uploaded does not mean playable; automatic subtitles remain environment-gated.

Read your film's change request and deletion-request status. No admin-only review scores or diagnostics.

The user's filmmaker profile as the Profile page shows it: username (the public handle) and why it cannot go public yet, display name, bio, location, roles, website and social links, whether the profile is public and its public link, plus how many credits from other filmmakers await an answer. The avatar is managed in the Profile page.

Identify the Vidreno account this connection belongs to. Call this when the user asks which account is connected.

Full details of one of the user's own projects, as the Studio editor shows them: every field, the roles with pay and their application counts, the publish checklist with the tool that completes each open item, whether it can be published, previous work and the films that could be listed as previous work, and the public and Studio links. Only the owner can read a project this way; anyone else's answers not found.

Read a permitted project's discussion. Replies accompany their parent; offset pages top-level posts.

Read a bounded page of automatic subtitle cues or a saved draft. Retain source_revision and version for editing.

Check an upload started with start_video_upload, upload_video_from_chat or start_film_upload: awaiting_file (includes the upload_url while it can still be used), uploading, ready (a hosted video comes with its details and a default embed code; a film file with the film and slot it was attached to), expired (start a new upload), or failed (chat imports only; includes failure_reason).

Full details of one hosted video: title, description, visibility, size, duration, views, player colour, category and its links, plus the direct HLS stream link (hls_url, a .m3u8 for third-party players and channel tools) when one is available and otherwise hls_status (ready, processing, not_encoded, not_included, private, unavailable) with hls_reason saying what is missing. HLS links are only given for public videos with ready adaptive quality versions (paid plans); plays through them count against the owner's bandwidth but record no views or earnings. In urls, share (/player/) is the public link to give out and embed_iframe the embed URL; manage (/video/) is the owner's own editing page, sign-in required, and anyone else opening it is sent to the player page — never hand it out as a share link.

Email (or re-send) the invite for a credit that carries an email address, so the person can claim it with their Vidreno account. The same limits as the app apply: a daily cap per account and no repeat email to the same address for the same film within a day. Returns the invite link too; with link_only it only mints the link (nothing is sent), as the editor's copy-link button does.

Read apps connected to your account and their granted permissions. Does not disconnect apps or expose tokens.

List your bonus materials, access rules, publication state and file readiness. Archive preserves access already promised to buyers.

The user's film orders (buy and rent), newest first, one row per order: film, purchase or rental, price before tax, the payment processor's fee (processor_fee_estimated is true until the real fee is known; it comes off the price first), Vidreno's 10% cut of what is left after that fee, paid or refunded, what was credited and what the order is worth in the balance today (net: 0 once refunded), and dates. Never includes who bought. Filter by film_id (public film id) or status; paginate with page/page_size. Read-only.

Read manual and automatic subtitle track metadata, versions, detection status and availability. Does not return cue text.

List the user's films (On Demand: free to watch or buy/rent), most recently edited first, with optional search and status filter. Returns public film ids to use with the other film tools. Paginate with page/page_size.

The applications the user has made to other people's projects (the Studio's Applications page), newest first: role, project, status, note and links, whether it can still be withdrawn, the owner's public profile card and the message thread.

Credits that other filmmakers added the user to on their films, pending first: the role and name as written, the film (id, title, status, public page) and the film owner's name. Pending ones await the user's answer (respond_to_credit); accepted ones show on the user's public profile.

List projects you have been invited to, including the invitation id used to accept or decline.

The user's cash-out requests, newest first: amount, status (requested, processing, paid or failed with the reason), method, masked destination, requested and paid dates. Read-only; the user requests payouts at https://vidreno.com/payouts. Paginate with page/page_size.

The applications to one of the user's projects (the Studio's Applicants tab), newest first, optionally for one role: each applicant's public profile card (name, handle, roles, location, website and social links, public films), their note and links, status, the owner's next moves, and the message thread. Open applications (submitted or shortlisted) by default; status all includes decided, withdrawn and closed ones.

List invitations you sent for a project you own. Invitations grant project access, not a role.

List the user's own projects (crew calls on Vidreno Projects), newest first: status (draft, live or closed), visibility, role count, how many applications are waiting, and the public and Studio links. Also says whether the user can post one (the filmmaker-profile requirements and the cap on live projects). Project ids are for the other project tools.

Search the fixed language catalogue. Use returned canonical codes for filtering and metadata, not free-text names.

List the user's hosted videos, newest first, with optional search and visibility filter. Returns public video ids to use with the other tools. Paginate with page/page_size. In urls, share (/player/) is the public link to give out and embed_iframe the embed URL; manage (/video/) is the owner's own editing page, sign-in required, and anyone else opening it is sent to the player page — never hand it out as a share link.

Pin or unpin a top-level post on a project you own. This is a project-owner feature, not admin moderation.

Post an update on your project or reply in a project you may access. Sends the same participant notifications as the website. Only post when requested.

Make an episode watchable on the series page. Refused, with the editor's message, until its video is ready (start_film_upload with asset: episode) and its season is published (publish_season). The first published, playable episode is what lets the series itself publish (publish_film).

Make a film public on its film page. Refused, with the same message the film editor shows, while the publish checklist is incomplete: title, poster, a ready main film, a price only when it is Buy or rent (a free-to-watch film publishes without one), and the creator's rights confirmation. The first time a film is published the user must agree to this statement, which you read to them in full before passing confirm_rights: true: "I confirm I own or hold every right needed to publish and sell this film, including music, footage, performances and releases from people in it. If it contains any sexual content or nudity, every performer was 18 or older and consented, and I keep records proving it. I accept full responsibility for any claim that it infringes someone's rights, as set out in the Terms of Service – Your warranties (/terms#your-warranties)." A film that already carries a confirmation is not asked again. The checklist comes back with how to finish each open item: update_film or start_film_upload where a tool can do it, publish_film with confirm_rights for the rights row, and the editor link for the poster, which is added in the film editor, not through this connection.

Explicitly put ready replacement versions live for an already-published film/series. Viewer access, copyright screening and readiness checks still apply.

Publish a project: it goes live on its page and, when public, on Projects and Jobs. Refused, with the same message the Studio editor shows, while the checklist is incomplete (title, logline, description, project type, location or remote, shoot dates or dates flexible, at least one role); the answer lists each open item with the tool that completes it (update_project or add_project_role). Also refused by the live-projects cap and while a project is under review. Publishing a closed project reopens it.

Make a season live on the series page. Refused, with the editor's message, until the season has an episode with a playable video (the episode itself may still be a draft: publishing the season is what lets its episodes be published with publish_episode). The series itself goes public with publish_film.

Read a project page you may access, including private projects you were invited to. Does not disclose owner-only applicant data.

Change an uploaded subtitle track's display label. Language and kind identify its slot and are not changed.

Delete an episode and its video; the episodes after it in the season are renumbered. Refused while the episode has been sold or is in a checkout (unpublish_episode instead). Confirm with the user before calling it.

Remove one credit from a film's credit list by credit_id (from get_film). A pending invite for it stops working.

Permanently remove an uploaded subtitle track. Confirm with the user first.

Remove a role from a project. A role that already has applications cannot be removed (mark it filled with update_project_role instead), so nobody's thread disappears.

Delete a season with all its episodes and their videos; the seasons after it are renumbered. Refused while the season or any of its episodes has been sold or is in a checkout (unpublish_season instead). Confirm with the user before calling it.

Set the order of a season's episodes: every episode id of that season exactly once, first to last; they are renumbered 1, 2, 3… Episodes do not move between seasons.

Reorder all bonus items. Supply every current bonus public id exactly once; a changed list is rejected.

Set the order of a film's credits: pass every credit_id of the film in the order they should appear.

Set the order of a series' seasons: every season id exactly once, first to last; they are renumbered 1, 2, 3…

Report a project discussion post for staff review; does not moderate or remove it.

Request staff deletion of a sold film you own. Immediately unpublishes it. Explicitly confirm buyers and renters will lose access if approved. This does not approve the request or delete the files.

Ask staff to manually review your held film, with a note. This does not approve, restore or moderate it.

The owner's move on an application to one of the user's projects: shortlist, accept or decline, with an optional message posted in the thread afterwards. The applicant is e-mailed, exactly as when the owner decides in the Studio. A decision is final (accepted and declined applications cannot be moved again).

Accept, decline or unlink a credit another filmmaker gave the user (credit_id from list_my_credits). Accepting a pending credit shows the film on the user's public profile; declining a pending one or unlinking an accepted one keeps the name on the film but removes the link to the user's account.

Accept or decline an invitation addressed to your account.

Recheck an uploaded main/HDR/audio file whose inspection failed or is overdue. This does not retry encoding or restart the transcoder.

Retry a failed protection change only while Studio allows it. This cannot retry an admin-only encoding job.

Withdraw an invitation to your project; revokes private-project access.

Search the open roles on Vidreno Jobs (public, live projects only): by free text, department or exact role, country, remote-friendly, pay type and project type, newest projects first, paged with limit and offset (total counts every match; follow next_offset while has_more is true). Each result is the role with its pay and the project (type, format, stage, location, dates, the owner's public profile card) and the public links. Role ids are for apply_to_role.

Post a message in an application's thread as the user, whether they are the project owner or the applicant; the other side is e-mailed, as from the Studio. Returns the whole thread. Not possible once the application was withdrawn.

Invite someone to your project by handle OR email; sends the Studio invitation email. This grants project access, not a role. Only send when requested by the user.

Explicitly enable, disable or generate automatic subtitles for your film/episode, only where the unfinished automatic-subtitle feature is enabled. Does not enable it for the environment.

Set or reset a device artwork focal position using the same crop rules as Studio.

Choose original languages from list_spoken_languages, or No dialogue. Manual choices take precedence over detection. An episode selection overrides series inheritance.

Request protected or clear film playback using Studio's protection safeguards. Applies to all episodes of a series. Never changes global DRM configuration.

Choose stereo Auto, generated stereo or an embedded track, and intentional silence, for a feature using the supported programme flow. Does not upload or attach files.

Mute or unmute your own email notifications for a project you can access.

Open a signed-in browser upload for film artwork, a season poster, an uploaded subtitle, or an existing bonus file/thumbnail. No arbitrary URL fetching. The upload uses the website's file validation and owner checks.

Open a browser handoff for an HDR master/trailer, stereo/5.1/Atmos file, or bonus video. Uses the ordinary film upload engine and Studio attachment checks. Uploads do not automatically publish a replacement.

Begin uploading a film's main film or trailer from the user's computer. Files cannot be sent through this connection: the tool returns an upload_url the user opens in their browser (signed in to Vidreno) to pick the file; the upload goes straight to Vidreno's film storage (outside plan storage) and is attached to the film when it finishes, replacing the current file in that slot. Afterwards call get_film to see the new file's state; get_upload_status with the upload_id works too. Links are single-use and expire after about an hour.

Open a signed-in browser handoff to replace your own profile avatar.

Open a signed-in browser handoff to replace a project cover you own.

Open a signed-in browser handoff to replace a hosted video's thumbnail you own.

Begin uploading a new video from the user's computer. Files cannot be sent through this connection: the tool returns an upload_url the user opens in their browser (signed in to Vidreno) to pick the file; the upload goes straight to Vidreno's storage with the metadata given here pre-filled. Afterwards call get_upload_status with the upload_id to get the finished video and its embed code. Links are single-use and expire after about an hour. This is also the right tool when the user attached the video in the chat unless this AI app can supply a temporary https download URL for the attachment (ChatGPT can; use upload_video_from_chat there).

Take an episode off the series page (back to draft). A published series left with no watchable episode returns to draft. Buyers keep their access.

Take a film off its public page (back to draft). Viewers who already bought or rented it keep their access.

Take a season off the series page (back to draft); its episodes keep their own status and show again when the season is republished. A published series left with no watchable episode returns to draft. Buyers keep their access.

Change creator mode and/or your marketing email preference. Only subscribe when the user explicitly asks. Does not change email, password, billing or payout settings.

Enable/disable a generated track, retry a failed translation, delete a generated track, or publish its saved draft. Requires its current source revision and version. Deleting original subtitles also cancels pending translations.

Set your hosted-player account default. Null clears the colour. Free accounts must show the earn banner; paid accounts may hide it.

Change an episode's title, synopsis, runtime, buy/rent price (US cents, minimum $1.00, null removes) or rental window. Only the fields given change; the same validation as the series editor applies. The video is replaced with start_film_upload (asset: episode), never here.