Videos APIEndpoints

Create a folder

POST
/v1/folders

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Header Parameters

Idempotency-Key?string

A unique value, such as a UUID, that makes a retry safe. A repeat with the same key, body and query parameters within 24 hours returns the first successful response instead of acting again; only successes are kept, so a failed request can be retried with its key.

Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/folders" \  -H "Idempotency-Key: 4f1c2b9e-6a1d-4e0b-9c35-1f7b8a2d3e4c" \  -H "Content-Type: application/json" \  -d '{    "name": "Testes",    "kind": "ab_tests",    "folder_id": null  }'
{  "id": "68b0000000000000000000c3",  "name": "Testes",  "kind": "ab_tests",  "folder_id": null,  "created_at": "2026-07-28T12:00:00.000Z",  "updated_at": "2026-07-28T12:00:00.000Z"}