Integration
How do I delete a video through the API?
CallDELETE /v1/projects/{projectId}/videos/{videoId}. The answer is 204. A
second call for the same video answers 404. See
Manage videos → Delete a video.
Can I upload from a browser on my own domain?
Partly. The file partPUT works from your own domain, and the ETag header is
readable. The create and complete calls are API calls, and today they allow
our dashboard origin only. So keep your API key on your server and make those
two calls there. See Direct upload → Browser.
Do abandoned or deleted uploads count against the monthly new-upload limit?
An upload that you create and never complete does not count. A video that you complete and then delete does count, in the month you created it. See Usage and plan limits → Limits.How is the webhook signing secret used?
Use it exactly as you get it. Read it as a UTF-8 string and keep thewhsec_
prefix. Do not decode it, and do not remove the prefix. See
Webhooks → Verify the signature.
Does a bulk import change the moderation hold?
No. A bulk import has no separate rule: each video in the import is one upload. A paid plan is never held for the free-plan review, which is Coming soon. See Moderation → Bulk imports and Webhooks → Are videos held.What can a playback key do?
Only one thing: create playback tokens, with POST /v1/projects/{projectId}/videos/{videoId}/playback-tokens. Any other route answers 403 with insufficient_scope. See
Accounts, projects, API keys and domains → Key scopes.
Can I verify localhost or a staging host as a domain?
localhost cannot be verified. A staging host needs its own verified domain: a
real public host with a TXT record. See
Accounts, projects, API keys and domains → Local and staging hosts.
How do I rotate a webhook signing secret?
Call the rotate route. It is API only today, so there is no dashboard button. Update your server with the new secret before you call it, because the old secret stops working right away. See Webhooks → Rotate the signing secret.Can I read my plan and usage with an API key?
Usage, yes.GET /v1/projects/{projectId}/usage accepts a project API key. Your
plan, GET /v1/billing/plan, needs your dashboard session cookie, not an API key.
See Usage and plan limits.
Do public videos need a token?
Not yet. The per-video public mode is Coming soon, so every video needs a playback token today. See Playback tokens → Public videos need no token.Free plan
What are the free-plan limits?
The free plan gives you 2 hours stored, 2 hours of new uploads per month, 2,000 watched minutes per month, 1 project, 1 verified domain, and playback up to 720p. Our logo shows on the player. See Get started → Free-plan limits.Can I sign up with my work email instead of Google or GitHub?
Not today. Sign-up uses Google or GitHub only. See Accounts, projects, API keys and domains → Sign in.Is phone verification required to upload?
No. Phone verification at sign-up is Coming soon, and it does not block an upload. See Phone verification.Will my first videos be held for review?
Not today. The free-plan review hold is Coming soon. A paid plan is never held for it. A team hold can affect any plan. See Moderation → Free accounts: the first videos.What quality can I play?
The free plan plays up to 720p. Starter plays up to 1080p. 4K playback is Coming soon. See Usage and plan limits → Limits.Can I hide your logo on the player?
Not today. Hiding the logo (white-label) needs a paid plan, and paid plans are Coming soon. See Plans and payment.How do I embed a video on my site?
Copy the embed code, or include the player script. Put a signed playback token in the link. See Embed a video on any website.Does deleting a video free my stored hours?
Yes, but not at once. Stored hours go down shortly after you delete the video. The delete does not reset your watched minutes, and the video still counts against your new-upload limit for the month. See Manage videos → Delete a video.How are videos protected from being shared?
Each playback uses a signed token, and the video can be locked to your verified domain. A copied link answers403 on another domain. See
How playback protection works.