Media Upload - Groniz Documentation

Uploading Files

Upload a local file and receive a URL you can use in posts:

groniz upload <file-path>

The command returns a JSON response with the uploaded file’s URL:

{
  "id": "img-123",
  "path": "https://api.groniz.com/your-file.jpg"
}

You must upload media files to Groniz before using them in posts. Many platforms (TikTok, Instagram, YouTube) require verified URLs and will reject external links.

Upload and Post Workflow

# 1. Upload the file
RESULT=$(groniz upload photo.jpg)
FILE_URL=$(echo "$RESULT" | jq -r '.path')

# 2. Use the URL in a post
groniz posts create \
  -c "Check out this photo!" \
  -m "$FILE_URL" \
  -s "2025-01-15T10:00:00Z" \
  -i "your-integration-id"

Supported File Types

Images
Videos
Audio
Documents

PNG, JPG, JPEG, GIF, WEBP, SVG, BMP, ICO

Video Upload Example

Platforms like TikTok, YouTube, and Instagram require video uploads through Groniz:

# Upload the video
VIDEO=$(groniz upload video.mp4)
VIDEO_URL=$(echo "$VIDEO" | jq -r '.path')

# Post to TikTok
groniz posts create \
  -c "New video! #fyp" \
  -m "$VIDEO_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"privacy_level":"PUBLIC_TO_EVERYONE"}' \
  -i "tiktok-integration-id"