Videos APIEndpoints

Start an auto test

POST
/v1/videos/{id}/experiments/{type}/run

Authorization

bearerAuth
AuthorizationBearer <token>

Paste your VTurb API token (vt_...). Sent as Authorization: Bearer <token>.

In: header

Path Parameters

id*string
type*string

Value in

  • "turbo"
  • "headline"
  • "smart_autoplay"

Request Body

application/json

Only turbo takes a body (speed_start / speed_end). headline and smart_autoplay configure their variants with PATCH beforehand and run with no body.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

curl -X POST "https://example.com/v1/videos/652f2b1e8f1b2c3d4e5f6a7b/experiments/turbo/run" \  -H "Content-Type: application/json" \  -d '{    "speed_start": 1.2,    "speed_end": 1.4  }'
{  "id": "652f2b1e8f1b2c3d4e5f6a7b",  "experiment": {    "type": "turbo",    "status": "running"  }}