api.video
  1. Videos - Delegated upload
api.video
  • Account
    • Show account
      GET
  • Analytics
    • List live stream player sessions
      GET
    • List player session events
      GET
    • List video player sessions
      GET
  • Authentication
    • Authenticate
      POST
    • Refresh token
      POST
  • Live
    • List all live streams
      GET
    • Create live stream
      POST
    • Delete a live stream
      DELETE
    • Show live stream
      GET
    • Update a live stream
      PATCH
    • Delete a thumbnail
      DELETE
    • Upload a thumbnail
      POST
  • Players
    • List all players
      GET
    • Create a player
      POST
    • Delete a player
      DELETE
    • Show a player
      GET
    • Update a player
      PATCH
    • Delete logo
      DELETE
    • Upload a logo
      POST
  • Videos - Delegated upload
    • Upload with an upload token
      POST
    • List all active upload tokens.
      GET
    • Generate an upload token
      POST
    • Delete an upload token
      DELETE
    • Show upload token
      GET
  • Videos
    • List all videos
    • Create a video
    • Delete a video
    • Show a video
    • Update a video
    • Upload a video
    • Show video status
    • Pick a thumbnail
    • Upload a thumbnail
  • Captions
    • List video captions
    • Delete a caption
    • Show a caption
    • Update caption
    • Upload a caption
  • Chapters
    • List video chapters
    • Delete a chapter
    • Show a chapter
    • Upload a chapter
  • Webhooks
    • List all webhooks
    • Create Webhook
    • Delete a Webhook
    • Show Webhook details
  1. Videos - Delegated upload

List all active upload tokens.

GET
/upload-tokens
Videos - Delegated upload
A delegated token is used to allow secure uploads without exposing your API key. Use this endpoint to retrieve a list of all currently active delegated tokens.
Tutorials using delegated upload.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://ws.api.video/upload-tokens'
Response Response Example
{
  "data": [
    {
      "createdAt": "2020-12-02T10:26:46.000Z",
      "expiresAt": "2020-12-02T11:26:46.000Z",
      "token": "to37YfoPDRR2pcDKa6LsUE0M",
      "ttl": 3600
    },
    {
      "createdAt": "2020-12-02T10:26:28.000Z",
      "expiresAt": null,
      "token": "to1W3ZS9PdUBZWzzTEZr1B79",
      "ttl": 0
    }
  ],
  "pagination": {
    "currentPage": 1,
    "currentPageItems": 2,
    "itemsTotal": 2,
    "links": [
      {
        "rel": "self",
        "uri": "/upload-tokens?currentPage=1&pageSize=25"
      },
      {
        "rel": "first",
        "uri": "/upload-tokens?currentPage=1&pageSize=25"
      },
      {
        "rel": "last",
        "uri": "/upload-tokens?currentPage=1&pageSize=25"
      }
    ],
    "pageSize": 25,
    "pagesTotal": 1
  }
}

Request

Query Params
sortBy
string 
optional
Allowed: createdAt, ttl. You can use these to sort by when a token was created, or how much longer the token will be active (ttl - time to live). Date and time is presented in ISO-8601 format.
Example:
ttl
sortOrder
string 
optional
Allowed: asc, desc. Ascending is 0-9 or A-Z. Descending is 9-0 or Z-A.
Example:
asc
currentPage
integer 
optional
Choose the number of search results to return per page. Minimum value: 1
Example:
2
pageSize
integer 
optional
Results per page. Allowed values 1-100, default is 25.
Example:
30

Responses

🟢200Success
application/json
Body
data
array[object (UploadToken) {4}] 
uploadToken
required
createdAt
string <date-time>
optional
When the token was created, displayed in ISO-8601 format.
Example:
2019-12-16T08:25:51.000Z
expiresAt
string <date-time>
optional
When the token expires, displayed in ISO-8601 format.
Example:
2019-12-16T09:25:51.000Z
token
string 
optional
The unique identifier for the token you will use to authenticate an upload.
Example:
to1tcmSFHeYY5KzyhOqVKMKb
ttl
integer 
optional
Time-to-live - how long the upload token is valid for.
>= 0<= 2147483647
pagination
object (Pagination) 
required
Example:
{"currentPage":3,"currentPageItems":20,"itemsTotal":123,"links":{"first":{"rel":"first","uri":"/videos/search?currentPage=1&pageSize=20"},"last":{"rel":"last","uri":"/videos/search?currentPage=6&pageSize=20"},"next":{"rel":"next","uri":"/videos/search?currentPage=4&pageSize=20"},"previous":{"rel":"previous","uri":"/videos/search?currentPage=2&pageSize=20"}},"pageSize":20,"pagesTotal":7}
currentPage
integer 
read-onlyoptional
The current page index.
currentPageItems
integer 
read-onlyoptional
The number of items on the current page.
itemsTotal
integer 
read-onlyoptional
Total number of items that exist.
links
array[object (PaginationLink) {2}] 
required
pageSize
integer 
read-onlyoptional
Maximum number of item per page.
pagesTotal
integer 
read-onlyoptional
Number of items listed in the current page.
Modified at 2023-08-15 05:52:15
Previous
Upload with an upload token
Next
Generate an upload token
Built with