Generate an upload token

POST

/upload-tokens

Videos - Delegated upload

Use this endpoint to generate an upload token. You can use this token to authenticate video uploads while keeping your API key safe. Tutorials using delegated upload.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://ws.api.video/upload-tokens' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ttl": 3600
}'

Response Example

200 - response

{
  "createdAt": "2020-12-02T10:13:19.000Z",
  "expiresAt": "2020-12-02T11:13:19.000Z",
  "token": "to1tcmSFHeYY5KzyhOqVKMKb",
  "ttl": 3600
}

Request

Body Params application/json

ttl

integer

optional

Time in seconds that the token will be active. A value of 0 means that the token has no exipration date. The default is to have no expiration.

>= 0<= 2147483647

Default:

Examples

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

🟠400Bad Request

Modified at 2023-08-15 05:52:15

List all active upload tokens.

Delete an upload token