Get an upload target

Selects an available file server and returns its base URL with an opaque upload session.

The response initializes a separate file-server transfer. It does not upload a file to this endpoint. Treat the session as a secret.

GET /v1/upload

Get an upload target

cURL

curl --request GET \
  --url https://api.videobase.com/v1/upload \
  --header 'X-Api-Key: <api-key>'

200

{
  "url": "https://fs1.vbvd.net",
  "session": "MTIzOjoyOjo...redacted"
}

Authorizations

ApiKeyHeaderApiKeyQuery

X-Api-Key · string · header · required

Recommended. Your 16-character Videobase API key.

Response

200

application/json

Available upload target.

url · string<uri> · required

Base URL of the selected file server.

session · string · required

Opaque upload authorization. Treat it as a secret.