Video API

Video API Reference

Build powerful video experiences with our REST API. Manage video content, metadata, and access control securely and efficiently.

Getting Started

1. Install SDK

Install our official SDK to simplify API interactions

npm install @deneks/video-api

2. Initialize Client

Create a new API client with your token

import { VideoClient } from '@deneks/video-api' client = new VideoClient({ token: 'YOUR_API_KEY' })

Authentication

Personal API Key

curl -H "Authorization: Bearer YOUR_API_KEY" \n     "https://api.deneks.video/v1/videos"

Best for development and quick testing

OAuth 2.0

Client ID: YOUR_CLIENT_ID
Client Secret: YOUR_CLIENT_SECRET

Recommended for production applications

Access Management

Manage access levels through the dashboard. You can:

  • Create and rotate API keys
  • Set usage limits per key
  • Monitor API activity in real-time
  • Revoke access instantly

Access Dashboard →

Endpoints

POST /v1/videos

Upload New Video

Request Body

{
  "file": "base64-encoded-video",
  "title": "My Video",
  "description": "Optional description",
  "tags": ["tag1", "tag2"]
}

Response

{
  "id": "video_12345",
  "status": "processing",
  "upload_time": "2025-09-26T12:34:56Z"
}

201 Created - Upload initiated

GET /v1/videos/{id}

Get Video Info

Path Parameters

"id": "video_12345"

Response

{
  "id": "video_12345",
  "title": "My Video",
  "status": "processed",
  "duration": 123,
  "formats": ["mp4", "webm"],
  "created_at": "2025-09-26T12:34:56Z"
}

200 OK - Success

More Endpoints

DELETE
v1/videos/{id}

Delete Video

Permanently delete a video by ID

PUT
v1/videos/{id}

Update Video

Update video metadata and settings

POST
v1/analyze

Analyze Video

Run AI analysis on video content