# PeerTube Video Upload API

**Canonical:** https://apis.io/apis/peertube/peertube-video-upload-api/  
**Provider:** PeerTube — https://apis.io/providers/peertube/  
**Base URL:** https://{instance}/api/v1  
**Documentation:** https://docs.joinpeertube.org/api/rest-getting-started

PeerTube Video Upload API is one of 54 APIs that [PeerTube](https://apis.io/providers/peertube/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Video Upload. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and rate-limit docs.

Operations dealing with adding video or audio. PeerTube supports two upload modes, and three import modes. ### Upload - [_legacy_](#operation/uploadLegacy), where the video file is sent in a single request - [_resumable_](#operation/uploadResumableInit), where the video file is sent in chunks You can upload videos more reliably by using the resumable variant. Its protocol lets you resume an upload operation after a network interruption or other transmission failure, saving time and bandwidth in the event of network failures. Favor using resumable uploads in any of the following cases: - You are transferring large files - The likelihood of a network interruption is high - Uploads are originating from a device with a low-bandwidth or unstable Internet connection, such as a mobile device ### Import - _URL_-based: where the URL points to any service supported by [youtube-dl](https://ytdl-org.github.io/youtube-dl/) - _magnet_-based: where the URI resolves to a BitTorrent resource containing a single supported video file - _torrent_-based: where the metainfo file resolves to a BitTorrent resource containing a single supported video file The import function is practical when the desired video/audio is available online. It makes PeerTube download it for you, saving you as much bandwidth and avoiding any instability or limitation your network might have.

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/peertube/refs/heads/main/openapi/peertube-video-upload-api-openapi.yml
- **Documentation** — https://docs.joinpeertube.org/api/rest-getting-started
- **APIReference** — https://docs.joinpeertube.org/api-rest-reference.html
- **Plugins** — https://docs.joinpeertube.org/api/plugins
- **EmbedPlayer** — https://docs.joinpeertube.org/api/embed-player
- **ActivityPub** — https://docs.joinpeertube.org/api/activitypub
- **Plans** — https://raw.githubusercontent.com/api-evangelist/peertube/refs/heads/main/plans/plans.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/peertube/refs/heads/main/rate-limits/rate-limits.yml
- **FinOps** — https://raw.githubusercontent.com/api-evangelist/peertube/refs/heads/main/finops/finops.yml

## Other PeerTube APIs (12)

- [PeerTube Abuses API](https://apis.io/apis/peertube/peertube-abuses-api/)
- [PeerTube Account Blocklist API](https://apis.io/apis/peertube/peertube-account-blocklist-api/)
- [PeerTube Accounts API](https://apis.io/apis/peertube/peertube-accounts-api/)
- [PeerTube Automatic Tags API](https://apis.io/apis/peertube/peertube-automatic-tags-api/)
- [PeerTube Channels Sync API](https://apis.io/apis/peertube/peertube-channels-sync-api/)
- [PeerTube Client Config API](https://apis.io/apis/peertube/peertube-client-config-api/)
- [PeerTube Config API](https://apis.io/apis/peertube/peertube-config-api/)
- [PeerTube Contact API](https://apis.io/apis/peertube/peertube-contact-api/)
- [PeerTube Debug API](https://apis.io/apis/peertube/peertube-debug-api/)
- [PeerTube Homepage API](https://apis.io/apis/peertube/peertube-homepage-api/)
- [PeerTube Instance Follows API](https://apis.io/apis/peertube/peertube-instance-follows-api/)
- [PeerTube Instance Redundancy API](https://apis.io/apis/peertube/peertube-instance-redundancy-api/)

## Tags

Video Upload

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/peertube/peertube-video-upload-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/peertube/.