Gumlet
Media & VideoGumlet is a video and image delivery platform with VOD transcoding, live streaming, and an image optimization CDN. Agents upload and manage video assets, run live streams, organize playlists and channels, purge caches, pull viewer analytics, and react to Gumlet webhook events.
What This Integration Enables
Gumlet is delivery infrastructure. What sits behind it is not a library your team browses, it is the set of URLs your product, your course platform, and your customers' pages are pointed at, which means the operations that matter are the ones that change what those URLs resolve to. FlowRunner agents ingest video by URL or by pushing bytes, attach subtitles and alternate audio tracks, run multipart uploads for very large sources, apply saved transcoding profiles, organize assets into workspaces, folders, and playlists, run and end live streams, manage image sources and purge their caches, invite and remove channel viewers, and pull viewer and usage analytics.
The single most useful thing about automating this connector is that several of Gumlet's ingest paths are multi-step, and skipping the final step fails without an error. Subtitles uploaded but never completed sit in storage while the asset looks entirely normal. A multipart upload never completed leaves the asset pending forever and it never transcodes. The connector collapses those exchanges into single operations, which turns a class of silent partial failures into either a finished asset or a real error. That is what a connectors layer is for: not calling the API, but calling it correctly every time.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Lesson to live, with captions actually attached
An approved lesson lands from the editing pipeline. The agent calls Upload Asset From URL, which creates the asset and pushes the bytes, because the source URL a workflow holds is usually a signed one Gumlet cannot fetch itself. Upload Subtitle From URL attaches the caption track in one call rather than three. When the ready event arrives the agent reads the playback URL, files the asset with Add Assets To Playlist, and posts to the course owner in Slack with the languages attached and any encode warning surfaced. If the warning says the source resolution was too low for the profile, the owner learns that now rather than from a viewer.
Image delivery that stays current after a content change
Product images are served from a Gumlet image source. When a listing is updated in Shopify, the agent calls Purge Image Cache for the exact paths that changed, without any transformation query attached, because a path with one does not match. Get Image Usage Analytics runs weekly into Google Sheets so bandwidth against a plan limit is a number someone watches rather than a surprise on an invoice.
A live event that pauses
A live workshop is streaming through a Gumlet live asset. Ingest drops. The agent sees it, checks Get Live Asset History, and has exactly one operation available that would tidy up the stream state. It does not call it. Whether ingest stopped because the session ended or because the presenter unplugged a laptop for the break is not something the stream state can answer, and the two situations have very different consequences.
Human-in-Loop Highlight
Completing a live stream is a one way operation. Once a live asset is completed it can never ingest again, so a broadcast that was only pausing cannot resume into the same asset, the same URL, or the same viewer session. Meanwhile the signal an agent has to work from is ingest state, which looks identical whether the event finished or the presenter's connection dropped during a break. That is a judgment, not a threshold, so the agent stops and pages the event owner: "Ingest on live asset 7c31 stopped 4 minutes ago. 214 viewers are still on the player. Completing the stream ends it permanently and this asset can never ingest again. Complete it, or hold the asset open?" The owner answers from their phone. Everything else in this connector runs unattended, including the deletes that a recycle bin can undo. The human-in-the-loop step sits on the one operation that has no reverse and an audience watching it happen.
Agent Capabilities
70 actionsVideo Assets
12- Create Asset Creates a video asset from a publicly reachable URL, which Gumlet then downloads and transcodes. Naming a profile on this call overrides every other transcoding setting except the source and the workspace.
- Create Asset Direct Upload Creates an asset and returns an upload URL to put bytes to. The lower level half of the push path.
- Upload Asset From URL Creates the asset and pushes the source bytes in one call. The right operation from a flow, because the source URL a workflow holds is usually one Gumlet cannot reach on its own.
- Get Asset Retrieves an asset with its processing state, progress, and playback URLs. The URLs only exist once processing has finished.
- List Assets Lists assets in a workspace, returning folders and assets together with the full current filter set.
- Update Asset Updates an asset's metadata and settings.
- Delete Asset Removes an asset and its storage, so every playback URL stops resolving. Recoverable only while it remains in the recycle bin.
- Recover Asset Restores a deleted asset from the recycle bin. The reason a delete on this connector can run unattended and completing a live stream cannot.
- Select Thumbnail Frame Picks the frame used as the asset's poster image from a timestamp in the video.
- Create Thumbnail Upload Returns an upload URL for a custom thumbnail image.
- Upload Thumbnail From URL Uploads a custom thumbnail from a source URL in one call.
- Set Asset Chapters Writes chapter markers onto an asset so the player can offer navigation inside a long recording.
Tracks
5- Create Subtitle Upload Issues one upload URL per subtitle language. The first step of a three step exchange.
- Complete Subtitle Upload Attaches uploaded subtitle files to the asset. Without this call the files sit in storage, the asset looks normal, and no error appears anywhere.
- Upload Subtitle From URL Runs all three subtitle steps for one language in a single call. The safe way to attach captions from a workflow.
- Create Audio Upload Issues an upload URL for an alternate audio track.
- Complete Audio Upload Attaches the uploaded audio track to the asset, and carries the same silent failure risk as subtitles if it is skipped.
Multipart Upload
2- Get Part Upload URL Returns an upload URL for one part of a very large file.
- Complete Multipart Upload Finalizes a multipart upload with the part numbers and the tag each part returned. Until this call the asset stays pending and never transcodes.
Profiles
5- Create Profile Creates a saved set of transcoding parameters that assets can be created against.
- List Profiles Lists the profiles configured on the account.
- Get Profile Retrieves one profile's full settings.
- Update Profile Updates a profile. Because a profile overrides individual settings on every asset created against it, this changes future encodes across the whole workspace.
- Delete Profile Removes a profile.
Playlists
8- Create Playlist Creates a playlist to group assets for a course, a channel, or a series.
- List Playlists Lists the playlists in a workspace.
- Get Playlist Assets Returns the assets in a playlist in their current order.
- Add Assets To Playlist Adds assets to a playlist.
- Remove Assets From Playlist Removes assets from a playlist without touching the assets themselves.
- Update Playlist Updates a playlist's settings and metadata.
- Delete Playlist Removes a playlist.
- Reorder Playlist Moves an asset to a new position. Positions are relative to the page the caller was looking at, so the page number, page size, sort field, and sort order all have to be sent with the move, and the connector checks for all of them before calling.
Workspaces
5- List Workspaces Lists the video workspaces the API key is scoped to. A missing workspace usually means the key rather than the workspace.
- Get Workspace Retrieves one workspace's configuration.
- Create Workspace Creates a workspace, which is the isolation boundary for assets and settings.
- Update Workspace Updates a workspace's settings.
- Delete Workspace Removes a workspace and every asset inside it from storage. This operation refuses to fall back to the connection's default workspace, so it can only ever act on an id it was given explicitly.
Folders
6- Create Folder Creates a folder inside a workspace.
- List Folders Lists folders in a workspace.
- Get Folder Retrieves a folder with its contents.
- Update Folder Updates a folder, and is also how assets are filed into one, since there is no separate add operation.
- Delete Folder Removes a folder, its descendant folders, and the assets inside them. Move the videos out first if they should survive.
- Remove Assets From Folder Takes assets out of a folder while leaving the assets themselves intact. The safe precursor to deleting a folder.
Live Streams
9- Create Live Asset Creates a live streaming asset with its ingest configuration.
- Update Live Asset Updates a live asset's settings before or between broadcasts.
- Get Live Asset Retrieves a live asset with its current state.
- Get Live Asset History Returns the state history of a live asset, which is what a monitoring flow reads when ingest behaves unexpectedly.
- List Live Assets Lists the live assets under a live source.
- Start Live Asset Puts a live asset into a state where it can accept ingest.
- Complete Live Stream Ends a live stream permanently. The asset can never ingest again, which is why this operation carries this page's human gate.
- Delete Live Asset Removes a live asset.
- Create Live Thumbnail Upload Returns an upload URL for a custom poster image on a live asset.
Image Sources
7- Create Image Source Creates an image optimization source with its own delivery subdomain.
- List Image Sources Lists the image sources on the account.
- Get Image Source Retrieves one image source's configuration.
- Update Image Source Updates an image source's optimization and delivery settings.
- Delete Image Source Removes an image source, and with it every image URL served on that subdomain.
- Purge Image Cache Purges cached paths for one image source by id. Paths must be sent without any transformation query attached, because a path with one does not match.
- Purge Cache By Subdomain Purges cached paths by subdomain label rather than by source id, which is the older addressing form and still the one some accounts use.
Analytics
5- Get Video Usage Analytics Returns video usage over a date range within the platform's video reporting window.
- Get Top Streamed Assets Returns the most streamed assets, which is the input for a rotation or archival decision.
- Get Image Usage Analytics Returns image delivery usage. Its reporting window is shorter than the video one, so a scheduled report has to ask for a range it will actually be given.
- Get Viewer Analytics Returns viewer behavior as a series and can nest several breakdown dimensions at once.
- Get Aggregated Data Returns single figures rather than series, which is the shape a threshold check or a dashboard tile actually wants.
Channel Viewers
3- Invite Channel Viewers Invites named viewers to a private channel.
- Remove Channel Viewers Revokes channel access for named viewers.
- Invite Channel Viewers From CSV Invites a batch of viewers from a CSV, which is how a cohort or a customer list is onboarded in one step.
Webhooks
3- Create Webhook Registers a webhook subscription on the organization.
- Update Webhook Updates a webhook's endpoint or settings.
- Delete Webhook Removes a webhook subscription.
Triggers
1 triggersEvent Triggers
1- On Gumlet Event Fires on Gumlet's delivered events, covering the whole transcoding lifecycle, viewer events including first view and lead capture, playlist and channel activity, and every live stream state. The subscription vocabulary and the delivery vocabulary differ, so the trigger subscribes broadly and filters on what actually arrives, which means choosing a specific event costs nothing. A workspace not named on the subscription sends no events at all, so the trigger takes a workspace list and falls back to the connection default. Each trigger registers its own webhook with its own secret, and Gumlet retries a failed delivery on a schedule, so a brief outage does not lose events.
Frequently Asked Questions
What can FlowRunner do with Gumlet?
FlowRunner agents can run Create Asset, Create Asset Direct Upload, and Upload Asset From URL in Gumlet, plus 67 more actions.
Does connecting Gumlet to FlowRunner require OAuth?
No. Gumlet connects to FlowRunner with an API key, no OAuth flow required.
Can Gumlet trigger a FlowRunner workflow automatically?
Yes. Gumlet supports 1 trigger that can start a FlowRunner workflow automatically.
Other Media & Video integrations
Start building with Gumlet
$100 in credits. No card required. Connect in minutes.