TubeForge API

Authentication

All API requests must include a Bearer token in the Authorization header.

Authorization: Bearer tf_your_api_key_here

Generate API keys in your account Settings page. Keys start with tf_ and are shown only once after generation. You can create up to 5 keys per account and revoke them at any time.

Base URL

https://tubeforge.co/api/v1

All endpoints are relative to this base URL. Always use HTTPS in production.

Rate Limits

Rate limits protect the API from abuse and ensure fair usage. Limits are applied per API key.

Response Headers

When the limit is exceeded, the API returns 429 with a Retry-After header indicating how many seconds to wait before retrying.

Endpoints

curl -X GET "https://tubeforge.co/api/v1/projects?page=1&limit=10" \
  -H "Authorization: Bearer tf_your_api_key"

{
  "data": [
    {
      "id": "clx1234abc",
      "title": "My Project",
      "description": "A great video project",
      "status": "DRAFT",
      "tags": ["tutorial", "ai"],
      "thumbnailUrl": null,
      "sceneCount": 5,
      "createdAt": "2026-03-20T10:00:00.000Z",
      "updatedAt": "2026-03-20T12:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "pages": 5
  }
}

curl -X POST "https://tubeforge.co/api/v1/projects" \
  -H "Authorization: Bearer tf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"title": "My New Project", "tags": ["tutorial"]}'

{
  "data": {
    "id": "clx5678def",
    "title": "My New Project",
    "description": "Created via API",
    "status": "DRAFT",
    "tags": ["tutorial"],
    "createdAt": "2026-03-20T14:00:00.000Z",
    "updatedAt": "2026-03-20T14:00:00.000Z"
  }
}

Try It

Test API endpoints directly from your browser using your API key. Requests are sent from your browser to https://tubeforge.co -- your key never leaves your machine.

Error Codes

All errors return a JSON body with an error field describing the issue.

{
  "error": "Unauthorized. Provide a valid Bearer token in the Authorization header."
}

Webhooks

Receive real-time HTTP notifications when events occur in your account. Configure webhooks in Settings or via the tRPC API. Only https:// URLs are accepted. Maximum 10 webhooks per account.

Each webhook delivery includes an HMAC-SHA256 signature in the X-Webhook-Signature header. Always verify the signature before processing the payload to ensure it came from TubeForge.

# Compute expected signature and compare:
echo -n '{"event":"project.created",...}' | \
  openssl dgst -sha256 -hmac "whsec_your_webhook_secret"

{
  "event": "project.created",
  "timestamp": "2026-03-20T14:00:00.000Z",
  "data": {
    "id": "clx5678def",
    "title": "My New Project",
    "description": null,
    "status": "DRAFT",
    "tags": ["tutorial"],
    "createdAt": "2026-03-20T14:00:00.000Z"
  }
}

{
  "event": "video.completed",
  "timestamp": "2026-03-20T15:30:00.000Z",
  "data": {
    "projectId": "clx5678def",
    "videoId": "vid_abc123",
    "title": "My New Project",
    "duration": 127,
    "resolution": "1080p",
    "fileSize": 52428800,
    "downloadUrl": "https://tubeforge.co/api/v1/videos/vid_abc123/download",
    "expiresAt": "2026-03-27T15:30:00.000Z"
  }
}

SDKs & Libraries