Create a video

POST/v1/videos

Authorization

bearerAuth

AuthorizationBearer <token>

API token issued from the dashboard (Settings → API Tokens). Sent as Authorization: Bearer <token>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title*string

Length1 <= length <= 300

number?integer

Omit to take the org's next free number (returned as nextNumber on the list).

Range0 <= value <= 9999

slug?string

Lowercase words separated by hyphens. Omit to derive from the title.

archetype?string

Default"flagship"

Value in"launch" | "flagship" | "course"

status?string

Default"idea"

targetRuntimeMin?|null

youtubeVideoId?string|null

publishedAt?string|null

competitorContentId?|null

notes?string|null

Response Body

`application/json`

cURL

curl -X POST "https://example.com/videos" \  -H "Content-Type: application/json" \  -d '{    "title": "string"  }'

{
  "success": true,
  "video": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "number": 19,
    "numberLabel": "0019",
    "slug": "buzz-jack-dorsey",
    "title": "string",
    "archetype": "launch",
    "status": "idea",
    "targetRuntimeMin": -9007199254740991,
    "youtubeVideoId": "string",
    "publishedAt": "string",
    "competitorContentId": "8b062da4-f8f0-4977-8458-a867b48ec58e",
    "notes": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

{
  "error": "unauthorized"
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

409application/json

`application/json`

`application/json`

`application/json`

`application/json`