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

Show upload token

GET
/upload-tokens/{uploadToken}
Videos - Delegated upload
You can retrieve details about a specific upload token if you have the unique identifier for the upload token. Add it in the path of the endpoint. Details include time-to-live (ttl), when the token was created, and when it will expire.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://ws.api.video/upload-tokens/to1tcmSFHeYY5KzyhOqVKMKb'
Response Response Example
200 - response
{
  "createdAt": "2020-12-02T10:13:19.000Z",
  "expiresAt": null,
  "token": "to1tcmSFHeYY5KzyhOqVKMKb",
  "ttl": 0
}

Request

Path Params
uploadToken
string 
required
The unique identifier for the token you want information about.
Example:
to1tcmSFHeYY5KzyhOqVKMKb

Responses

🟢200Success
application/json
Body
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
🟠404Not Found
Modified at 2023-08-15 05:52:15
Previous
Delete an upload token
Next
List all videos
Built with