Stillhaven

Get account and usage

Read the account this connection acts for: its plan, and how much storage and bandwidth it has used against the plan allowance. Call this when someone asks what plan they are on, how much room is left, or whether an upload will fit.

List videos

List videos in the account, newest first, with optional filters. Returns id, title, status, duration, folder, and share link for each. Embed codes are not included because they are long: call get_video when someone needs one. Trashed videos are not listed.

Search videos by title

Find videos whose title contains the given text, without paging through the whole library. Use this when someone names a video rather than giving an id. Matching ignores case.

Get one video

Read everything about one video, including its embed code, share link, share page settings, and which domains may embed it. Call this before changing a video, so you are working from what is stored rather than what was said.

Get video analytics

Read how often one video was played and loaded over a window, plus lifetime counts of how far viewers got through it. There is no per-video bandwidth figure and no viewer count: neither is measured. Use get_account for bandwidth.

Update a video

Change a video title, description, or folder. Only the fields you send are changed and the rest are left alone. Read the video first if you are unsure what is stored.

Start a video upload

Start an upload and return what the person needs to send the file themselves. Uploading is a multi-step job that the file owner does directly with the storage service: this returns a video id, how many parts to send, and how big each part is, and the file never passes through this connector. Explain the steps rather than attempting the upload yourself.

Move a video to trash

Move a video to trash. This is reversible: nothing is deleted permanently, the video can be restored for 30 days with restore_video, and permanent deletion is only possible in the Stillhaven console. Say so when you report what you did.

Restore a video from trash

Bring a video back out of trash and into the library. Works for 30 days after it was trashed.

List channels

List the account channels, newest first, with how many videos each holds and its public link. A channel is a playlist with a page of its own.

Get one channel

Read one channel, including the exact order of the videos in it. Call this before set_channel_videos so you can send back the full order rather than guessing at it.

Set a channel playlist

Replace the whole list of videos in a channel and the order they play in. This is a replacement, not an addition: any video you leave out is removed from the channel. Read the channel first with get_channel and send back the full list you intend.

Set where a video may be embedded

Control which websites may embed one video. Use inherit to follow the account default, locked to allow only the domains you list, or open to allow every site. Send bare hostnames like example.com, with no scheme and no path.