Skip to main content

Configure Video at Position

  • Method: POST
  • URL: https://api.tokportal.com/video-configure-at-position
  • Auth: X-API-Key

Body (video type):

{
  "bundle_id": "<uuid>",
  "position": 1,
  "video_type": "video",
  "description": "Desc",
  "video_url": "https://cdn.example.com/v123.mp4",
  "tiktok_sound_url": null,
  "target_start": "2025-09-05T00:00:00Z",
  "editing_instructions": "Cut 3s",
  "external_ref": null
}

Example:

curl -i -X POST -H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"bundle_id":"'$BUNDLE_ID'","position":1,"video_type":"video","description":"Desc API","video_url":"https://cdn.example.com/v123.mp4","target_start":"2025-08-05T00:00:00Z"}' \
  https://api.tokportal.com/video-configure-at-position

Notes:

  • video_url must comply with 06-media-requirements.md (public, direct file URL, stable ≥ 30 days). Broken/expired links are not refunded and require a new slot.
  • Start date is clamped to current_date + 3; end date is start + 3 days.
  • editing_instructions consumes edit credits if enabled for the bundle.
  • Only video type is supported by this strict variant.