app.swaggerhub.com Open in urlscan Pro
54.84.206.156  Public Scan

Form analysis
0 forms found in the DOM

Text Content

Sign UpLog In


PUT.IO

 2.8.11 

OAS 3.0

Start by registering your application and obtaining your API credentials from
OAuth Apps page.

The API is CORS enabled. All API responses include following header:

Access-Control-Allow-Origin: "*"


We have clients for folowing languages at the moment:

 * Python
 * JavaScript
 * Go
 * Swift

And, if you want to share, you can tell us what you are building at info@put.io

If you want to try API methods via Swagger UI, use implicit authorization type
and pass 3270 as client_id.

There is also OOB flow for authorizing from devices without a proper browser or
keyboard.

We are applying rate limits per token and IP addresses. The limits vary per
endpoints and how many requests the client does for a period. The response
status will be 429 and include X-RateLimit-Remaining, X-RateLimit-Limit and
X-RateLimit-Reset headers. So, your application must consider ratelimit headers.

Terms of service
Contact API Support
Servers
https://api.put.io/v2
Authorize



ACCOUNT

MANAGE YOUR ACCOUNT AND SETTINGS

GET
/account/info
Get account info
GET
/account/settings
Get account settings


FILES

MANAGE YOUR FILES

GET
/files/list
List files and their properties
POST
/files/list/continue
Fetch remaining files via cursor
GET
/files/search
Search your and your friends' files
POST
/files/search/continue
Fetch rest of the search results
POST
/files/create-folder
Create new folder
POST
/files/rename
Rename file
POST
/files/move
Move files
POST
/files/{id}/mp4
Convert file to MP4
GET
/files/{id}/mp4
Get MP4 conversion status
GET
/files/{id}/subtitles
List available subtitles
GET
/files/{id}/subtitles/{key}
Download subtitle file
GET
/files/{id}/hls/media.m3u8
Download HLS playlist for video file
POST
/files/delete
Delete files
POST
/files/upload
Upload file
GET
/files/{id}/url
Get download URL
GET
/files/extract
List active extractions
POST
/files/extract
Extract ZIP and RAR archives
GET
/files/{id}/start-from
Get video position
POST
/files/{id}/start-from
Set video position
POST
/files/{id}/start-from/delete
Delete video position
GET
/files/search/{query}/page/{page}
Search your and your friends' files
GET
/files/{id}
Get properties of file
GET
/files/{id}/download
Download file


TRANSFERS

MANAGE YOUR TRANSFERS

GET
/transfers/list
List all transfers
GET
/transfers/{id}
Get transfer details
POST
/transfers/add
Add new transfer from URI
POST
/transfers/retry
Retry failed transfer
POST
/transfers/cancel
Cancel or remove transfers
POST
/transfers/clean
Clean finished transfers
POST
/transfers/remove
Remove transfers


CONFIG

KEY-VALUE STORAGE FOR APP TO STORE USER SPECIFIC DATA

GET
/config
Read config object
PUT
/config
Write config object
GET
/config/{key}
Get single config value
PUT
/config/{key}
Set single config value
DELETE
/config/{key}
Delete single config value


ZIPS

DOWNLOAD MULTIPLE FILES/FOLDERS AS ZIP FILE

POST
/zips/create
Create a ZIP link
GET
/zips/list
List active zipping jobs
GET
/zips/{id}
Get zipping job details


SHARES

MANAGE YOUR SHARED FILES

POST
/files/share
Shares files with friends
GET
/files/shared
List your shared files
GET
/files/{id}/shared-with
List users that the file is shared with
POST
/files/{id}/unshare
Unshare file


FRIENDS

MANAGE YOUR FRIENDS

GET
/friends/list
List friends
GET
/friends/waiting-requests
List incoming friend requests
POST
/friends/{username}/request
Send friend request
POST
/friends/{username}/approve
Approves friend request
POST
/friends/{username}/deny
Deny friend request
POST
/friends/{username}/unfriend
Remove friend


RSS

MANAGE YOUR RSS FEEDS

GET
/rss/list
List RSS feeds
GET
/rss/{id}
Get feed properties
POST
/rss/{id}
Update RSS feed
POST
/rss/create
Create RSS feed
POST
/rss/{id}/pause
Pause feed
POST
/rss/{id}/resume
Resume feed
POST
/rss/{id}/delete
Delete RSS feed


EVENTS

LIST OR DELETE YOUR EVENTS

GET
/events/list
List events
POST
/events/delete
Clear events


OOB

GET
/oauth2/oob/code
Get a new OOB authentioncation code
GET
/oauth2/oob/code/{code}
Check if the code is linked to the user's account

SCHEMAS

Error
AccountInfo
AccountSettings
File
FileType
Extraction
Transfer
RssFeed
Friend
Config
ConfigValue
OOBCode
OAuthToken