peertube

name	peertube
description	PeerTube API skill. Use when working with PeerTube for static, download, feeds. Covers 265 endpoints.
version	1.0.0
generator	lapsh

PeerTube

API version: 8.0.0

Auth

OAuth2

Base URL

https://peertube2.cpy.re

Setup

1. Configure auth: OAuth2
2. GET /feeds/podcast/videos.xml -- verify access
3. POST /api/v1/config/instance-banner/pick -- create first pick

Endpoints

265 endpoints across 4 groups. See references/api-spec.lap for full details.

static

Method	Path	Description
GET	/static/web-videos/{filename}	Get public Web Video file
GET	/static/web-videos/private/{filename}	Get private Web Video file
GET	/static/streaming-playlists/hls/{filename}	Get public HLS video file
GET	/static/streaming-playlists/hls/private/{filename}	Get private HLS video file

download

Method	Path	Description
GET	/download/videos/generate/{videoId}	Download video file

feeds

Method	Path	Description
GET	/feeds/video-comments.{format}	Comments on videos feeds
GET	/feeds/videos.{format}	Common videos feeds
GET	/feeds/subscriptions.{format}	Videos of subscriptions feeds
GET	/feeds/podcast/videos.xml	Videos podcast feed

api

Method	Path	Description
GET	/api/v1/accounts/{name}	Get an account
GET	/api/v1/accounts/{name}/videos	List videos of an account
GET	/api/v1/accounts/{name}/followers	List followers of an account
GET	/api/v1/accounts	List accounts
GET	/api/v1/config	Get instance public configuration
GET	/api/v1/config/about	Get instance "About" information
GET	/api/v1/config/custom	Get instance runtime configuration
PUT	/api/v1/config/custom	Set instance runtime configuration
DELETE	/api/v1/config/custom	Delete instance runtime configuration
POST	/api/v1/config/instance-banner/pick	Update instance banner
DELETE	/api/v1/config/instance-banner	Delete instance banner
POST	/api/v1/config/instance-avatar/pick	Update instance avatar
DELETE	/api/v1/config/instance-avatar	Delete instance avatar
POST	/api/v1/config/instance-logo/{logoType}/pick	Update instance logo
DELETE	/api/v1/config/instance-logo/{logoType}	Delete instance logo
GET	/api/v1/custom-pages/homepage/instance	Get instance custom homepage
PUT	/api/v1/custom-pages/homepage/instance	Set instance custom homepage
POST	/api/v1/jobs/pause	Pause job queue
POST	/api/v1/jobs/resume	Resume job queue
GET	/api/v1/jobs/{state}	List instance jobs
GET	/api/v1/server/followers	List instances following the server
DELETE	/api/v1/server/followers/{handle}	Remove or reject a follower to your server
POST	/api/v1/server/followers/{handle}/reject

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "Get web-video details?" -> GET /static/web-videos/{filename}
• "Get private details?" -> GET /static/web-videos/private/{filename}
• "Get hl details?" -> GET /static/streaming-playlists/hls/{filename}
• "Get private details?" -> GET /static/streaming-playlists/hls/private/{filename}
• "Get generate details?" -> GET /download/videos/generate/{videoId}
• "Get video-comments.{format} details?" -> GET /feeds/video-comments.{format}
• "Get videos.{format} details?" -> GET /feeds/videos.{format}
• "Get subscriptions.{format} details?" -> GET /feeds/subscriptions.{format}
• "List all videos.xml?" -> GET /feeds/podcast/videos.xml
• "Get account details?" -> GET /api/v1/accounts/{name}
• "Search videos?" -> GET /api/v1/accounts/{name}/videos
• "Search followers?" -> GET /api/v1/accounts/{name}/followers
• "List all accounts?" -> GET /api/v1/accounts
• "List all config?" -> GET /api/v1/config
• "List all about?" -> GET /api/v1/config/about
• "List all custom?" -> GET /api/v1/config/custom
• "Create a pick?" -> POST /api/v1/config/instance-banner/pick
• "Create a pick?" -> POST /api/v1/config/instance-avatar/pick
• "Create a pick?" -> POST /api/v1/config/instance-logo/{logoType}/pick
• "Delete a instance-logo?" -> DELETE /api/v1/config/instance-logo/{logoType}
• "List all instance?" -> GET /api/v1/custom-pages/homepage/instance
• "Create a pause?" -> POST /api/v1/jobs/pause
• "Create a resume?" -> POST /api/v1/jobs/resume
• "Get job details?" -> GET /api/v1/jobs/{state}
• "List all followers?" -> GET /api/v1/server/followers
• "Delete a follower?" -> DELETE /api/v1/server/followers/{handle}
• "Create a reject?" -> POST /api/v1/server/followers/{handle}/reject
• "Create a accept?" -> POST /api/v1/server/followers/{handle}/accept
• "List all following?" -> GET /api/v1/server/following
• "Create a following?" -> POST /api/v1/server/following
• "Delete a following?" -> DELETE /api/v1/server/following/{hostOrHandle}
• "Create a user?" -> POST /api/v1/users
• "Search users?" -> GET /api/v1/users
• "Delete a user?" -> DELETE /api/v1/users/{id}
• "Get user details?" -> GET /api/v1/users/{id}
• "Update a user?" -> PUT /api/v1/users/{id}
• "List all local?" -> GET /api/v1/oauth-clients/local
• "Create a token?" -> POST /api/v1/users/token
• "Create a revoke-token?" -> POST /api/v1/users/revoke-token
• "List all token-sessions?" -> GET /api/v1/users/{id}/token-sessions

Response Tips

• Check response schemas in references/api-spec.lap for field details
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP