Media
Reference
The workflows behind the media studio, grouped by what they do, and the limits that apply. Full inputs and outputs are on reference.orkestia.dev
TL;DR
The studio is a client of these workflows. Call them from the API, the CLI, MCP or a Staff actor. Inputs and outputs: reference.orkestia.dev.
Posting (publisher.*)
| Workflow | Does |
|---|---|
publisher.snapshot | Today: waiting, next 7 days, failed, accounts, looks missing covers |
publisher.post.create-with-approval | A post for one channel, sent for review |
publisher.post.revise · .cancel · .retry | Change, cancel or retry a post |
publisher.review.list · publisher.review.decide | The review queue; approve or ask for changes |
publisher.calendar.list | Posts by date |
publisher.profile.upsert · .archive · data.publisher.profile.list | Looks |
publisher.cover_kit.upsert · .add-asset · .remove-asset · .archive · data.publisher.cover_kit.list | Cover kits and covers |
publisher.org_settings.get · .upsert | Who approves posts |
publisher.post.publish-due | Publishes approved posts when their time comes |
Video (video.*, data.video.*)
| Workflow | Does |
|---|---|
data.video.template.list · data.video.template.get | Your templates (with keys) and one version |
video.template.save | A new template, a copy, or the next version |
video.template.validate | Checks a template document |
data.video.brand-kit.get · video.brand-kit.save | Brand kit |
video.render.validate | Checks a production (template + words + brand kit + size + look) |
video.render.video | Renders an MP4 and a poster into Files, for review |
data.video.render.usage | The month's renders against the allowance, and finished renders |
Channels
| Workflow | Does |
|---|---|
data.youtube.channel.branding.get · youtube.channel.branding.update | YouTube name, description, keywords, country, banner |
data.meta.page.profile.get · meta.page.profile.update | Facebook Page picture, cover, about, description, website |
data.youtube.channel.list · data.meta.identity.list · data.linkedin.identity.list | The accounts a connection can post as |
Files (storage.*)
| Workflow | Does |
|---|---|
data.storage.object.search | Files by name and kind |
data.storage.object.preview-url | A short-lived link to view a file |
Limits
| What | Limit |
|---|---|
| Scenes per video | 40 |
| Video length | 3 minutes |
| List items | 8 |
| Image in a scene | JPEG, PNG, WebP; 25 MB |
| Clip in a scene | MP4, WebM, MOV; 400 MB |
| Brand logo | SVG, 64 KiB, no scripts or outside links |
| YouTube banner | JPEG or PNG, 2048×1152 or larger, 6 MB |
| Facebook picture / cover | JPEG or PNG; 4 MB / 10 MB |
| Renders | 30 a month and 2 at once per organization; 4 at once on the platform |
Agents and media
How Staff actors make videos and posts with the same workflows people use. The rules they follow, the flow from a brief to a reviewed video, and what they must never do
Limits and troubleshooting
What the studio does not do yet, and what to do when a post, a render or a channel edit is refused