Upload File

Documentation Index

Fetch the complete documentation index at: https://docs.genviral.io/llms.txt

Use this file to discover all available pages before exploring further.

​

How It Works

1. Call this endpoint with the file’s content type
2. Receive a presigned uploadUrl and the final url (CDN URL)
3. Upload your file directly to the uploadUrl using a PUT request
4. Use the url in post creation requests or pack-image attachment requests

​

Body Parameters

​

Response

• uploadUrl - Presigned URL to upload your file (expires in 10 minutes)
• url - CDN URL where your file will be accessible after upload
• contentType - The content type you specified
• expiresIn - Seconds until the upload URL expires (600)

​

Using With Packs

1. Call this endpoint and capture data.uploadUrl + data.url.
2. Upload your bytes to data.uploadUrl with PUT.
3. Call Add Pack Image with image_url = data.url.

​

Examples

​

Upload a video

import fetch from "node-fetch";

// Step 1: Get upload URL
const response = await fetch("https://www.genviral.io/api/partner/v1/files", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    contentType: "video/mp4",
    filename: "my-video.mp4",
    duration_sec: 42,
    bytes: 8_000_000,
  }),
});

const { data } = await response.json();
// data.uploadUrl = presigned S3 URL
// data.url = https://cdn.vireel.io/partner-api/workspaces/{workspaceId}/... (or /users/{ownerUserId}/...)

// Step 2: Upload file to presigned URL
const fileBuffer = fs.readFileSync("./my-video.mp4");
await fetch(data.uploadUrl, {
  method: "PUT",
  headers: {
    "Content-Type": "video/mp4",
  },
  body: fileBuffer,
});

// Step 3: Use the CDN URL in your post
await fetch("https://www.genviral.io/api/partner/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    caption: "Check this out!",
    media: {
      type: "video",
      url: data.url, // Use the CDN URL
    },
    accounts: [{ id: "account-id" }],
  }),
});

# Step 1: Get upload URL
curl --request POST \
  --url https://www.genviral.io/api/partner/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "contentType": "video/mp4",
    "filename": "my-video.mp4",
    "duration_sec": 42,
    "bytes": 8000000
  }'

# Step 2: Upload to presigned URL (use uploadUrl from response)
curl --request PUT \
  --url "<uploadUrl from step 1>" \
  --header 'Content-Type: video/mp4' \
  --data-binary @my-video.mp4

# Step 3: Use url in your post request

{
  "ok": true,
  "code": 201,
  "message": "Upload URL generated",
  "data": {
    "uploadUrl": "https://storage.example.com/presigned-url...",
    "url": "https://cdn.vireel.io/partner-api/workspaces/workspace_123/abc123.mp4",
    "contentType": "video/mp4",
    "expiresIn": 600
  }
}

​

Error Responses

• 400 invalid_json - Request body is not valid JSON
• 422 invalid_payload - Invalid content type or missing required fields
• 401 - authentication failed (missing/invalid/revoked token)
• 402 subscription_required - active Creator/Professional/Business plan required
• 403 tier_not_allowed - Scheduler tier cannot use Partner API
• 500 create_failed - Failed to initialize upload (retry)