TuzzleTuzzle Docs

Quick Start

Get up and running with Tuzzle in 5 minutes.

This guide walks you through uploading your first file and delivering it through the CDN.

1. Get Your API Key

Sign up at app.tzzl.io and create your first space. Then generate an API key from Settings > API Keys in the dashboard.

Your API key looks like this:

sk_a1b2c3d4e5f6g7h8i9j0...

Store your API key securely. It is only shown once at creation time.

2. Upload a File

curl -X POST https://api.tzzl.io/api/v1/upload \
  -H "Authorization: Bearer sk_a1b2c3d4..." \
  -F "[email protected]" \
  -F "space=a1b2c3"

{
  "data": {
    "id": "01HQ...",
    "name": "image-01HQ...",
    "original_name": "photo.jpg",
    "mime_type": "image/jpeg",
    "size": 245000,
    "storage_path": "a1b2c3/image-01HQ...",
    "type": "upload",
    "resource_type": "image"
  }
}

3. Deliver via CDN

Access your file through the CDN using the space handle and file name:

https://cdn.tzzl.io/a1b2c3/image-01HQ...

Add transformation parameters to resize, convert format, or adjust quality:

https://cdn.tzzl.io/a1b2c3/image-01HQ...?w=400&h=300&f=webp&q=80

4. Manage Your Assets

List files in your space:

curl "https://api.tzzl.io/api/v1/files?space_id=SPACE_ID" \
  -H "Authorization: Bearer sk_a1b2c3d4..."

Delete a file:

curl -X DELETE https://api.tzzl.io/api/v1/files/FILE_ID \
  -H "Authorization: Bearer sk_a1b2c3d4..."

Next Steps

PreviousIntroductionNextConcepts