API Overview

drop.mov provides a RESTful API for programmatic access to all platform features.

Base URL

Production: https://api.drop.mov/v1
Development: http://localhost:3000/v1

API Endpoints

The API is organized into three main contexts:

Context	Base Path	Description
User	/v1/user	Authenticated user operations
Manager	/v1/manager	Media group management
Viewer	/v1/viewer	Shared media access

Response Format

All responses are JSON with a consistent envelope structure:

Success Response

{
  "success": true,
  "data": { ... }
}

Error Response

{
  "success": false,
  "error": {
    "type": "bad_request",
    "message": "Detailed error message"
  }
}

Error Types

Error Type	HTTP Status	Description
bad_request	400	Invalid request parameters
unauthorized	401	Missing or invalid authentication
forbidden	403	Insufficient permissions
not_found	404	Resource not found
rate_limit	429	Too many requests
system_error	500	Internal server error

Rate Limiting

API requests are rate-limited to ensure fair usage:

Endpoint Type	Limit
General	100 requests/minute
Upload	10 requests/minute
Comments	30 requests/minute

Rate limit headers are included in responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1609459200

OpenAPI Specification

The complete OpenAPI specification is available at:

https://api.drop.mov/v1/openapi.json

Interactive API documentation (Scalar):

https://api.drop.mov/v1/docs