API

Enable API access from your dashboard. You choose once the visibility, interaction and disclosure settings applied to videos sent through the API, and receive a key. Authenticate every request with Authorization: Bearer <key>.

Schedule a post

POST /api/v1/posts with a publicly reachable HTTPS video URL. Omit scheduled_at to publish right away.

curl -X POST https://cue.florentklein.dev/api/v1/posts \
  -H "Authorization: Bearer $CUE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "caption": "My new video #fyp",
    "scheduled_at": "2026-11-01T18:00:00Z"
  }'

Or upload the file directly as multipart form data:

curl -X POST https://cue.florentklein.dev/api/v1/posts \
  -H "Authorization: Bearer $CUE_API_KEY" \
  -F video=@video.mp4 -F caption="My new video" -F scheduled_at=2026-11-01T18:00:00Z

Response:

{ "id": "…", "status": "scheduled", "scheduled_at": "2026-11-01T18:00:00.000Z" }

Check a post

curl https://cue.florentklein.dev/api/v1/posts/<id> -H "Authorization: Bearer $CUE_API_KEY"

status is one of scheduled, publishing, processing, published, failed or canceled. Once published, it may take a few minutes for the video to be visible on your profile.