Quickstart

1. Set your API key

export EDEN_API_KEY="eden_live_xxxxxxxxxxxxxxxxxxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"

$env:EDEN_API_KEY = "eden_live_xxxxxxxxxxxxxxxxxxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"

Treat your API key like a password. Never embed it in client code or commit it to source control.

2. Submit a video

curl -X POST https://api.myeden.me/v1/videos \
  -H "Authorization: Bearer $EDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.example.com/highlights/game-7.mp4",
    "title": "Game 7 — Final Two Minutes",
    "tags": ["nba", "playoffs"],
    "sport": "basketball"
  }'

const res = await fetch('https://api.myeden.me/v1/videos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.EDEN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    source_url: 'https://cdn.example.com/highlights/game-7.mp4',
    title: 'Game 7 — Final Two Minutes',
    tags: ['nba', 'playoffs'],
    sport: 'basketball',
  }),
});
const { id } = await res.json();
console.log('Ingested', id);

import os, requests

res = requests.post(
    "https://api.myeden.me/v1/videos",
    headers={"Authorization": f"Bearer {os.environ['EDEN_API_KEY']}"},
    json={
        "source_url": "https://cdn.example.com/highlights/game-7.mp4",
        "title": "Game 7 — Final Two Minutes",
        "tags": ["nba", "playoffs"],
        "sport": "basketball",
    },
)
print(res.json())

Response:

{
  "id": "vid_a7Kp9mNqR2vXyB4dH6jL8s",
  "status": "processing",
  "resource_url": "/v1/videos/vid_a7Kp9mNqR2vXyB4dH6jL8s",
  "message": "Video accepted. It typically takes 2–5 minutes to become available."
}

Save the id. You’ll use it to check status, archive, republish, or delete this video. Store it in your CMS alongside the source URL.

3. Check status

curl https://api.myeden.me/v1/videos/vid_a7Kp9m... \
  -H "Authorization: Bearer $EDEN_API_KEY"

While processing:

{
  "id": "vid_a7Kp9mNqR2vXyB4dH6jL8s",
  "status": "processing",
  "is_available": false,
  "title": "Game 7 — Final Two Minutes",
  "tags": ["nba", "playoffs"],
  "playback": null,
  "created_at": "2026-05-22T14:30:00Z"
}

When ready:

{
  "id": "vid_a7Kp9mNqR2vXyB4dH6jL8s",
  "status": "ready",
  "is_available": true,
  "title": "Game 7 — Final Two Minutes",
  "duration_seconds": 124,
  "playback": {
    "playback_id": "abc123XYZ",
    "hls_url": "https://stream.mux.com/abc123XYZ.m3u8",
    "thumbnail_url": "https://image.mux.com/abc123XYZ/thumbnail.jpg"
  },
  "created_at": "2026-05-22T14:30:00Z",
  "updated_at": "2026-05-22T14:33:12Z"
}

The video is now live on Eden across iOS, tvOS, Android, and web.

Playback URLs require a signed token to play. The Eden apps handle this automatically. If you need to embed playback elsewhere, contact Eden for details on the token-signing flow.

Getting started

Working with videos

1. Set your API key

2. Submit a video

3. Check status

​1. Set your API key

​2. Submit a video

​3. Check status

1. Set your API key

2. Submit a video

3. Check status