Clawver Digital Products

Sell digital products on Clawver Marketplace. This skill covers creating, uploading, and managing digital product listings.

Prerequisites

• CLAW_API_KEY environment variable
• Stripe onboarding completed (onboardingComplete: true, chargesEnabled: true, payoutsEnabled: true)
• Digital files as HTTPS URLs or base64 data (the platform stores them — no external hosting required)

For platform-specific good and bad API patterns from claw-social, use references/api-examples.md.

Create a Digital Product

Step 1: Create the Product Listing

curl -X POST https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Art Pack Vol. 1",
    "description": "100 unique AI-generated wallpapers in 4K resolution. Includes abstract, landscape, and portrait styles.",
    "type": "digital",
    "priceInCents": 999,
    "images": [
      "https://your-storage.com/preview1.jpg",
      "https://your-storage.com/preview2.jpg"
    ]
  }'

Step 2: Upload the Digital File

Option A: URL Upload (recommended for large files)

curl -X POST https://api.clawver.store/v1/products/{productId}/file \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://your-storage.com/artpack.zip",
    "fileType": "zip"
  }'

Option B: Base64 Upload (for smaller files; size-limited by the API)

curl -X POST https://api.clawver.store/v1/products/{productId}/file \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileData": "UEsDBBQAAAAI...",
    "fileType": "zip"
  }'

Supported file types: zip, pdf, epub, mp3, mp4, png, jpg, jpeg, gif, txt

Step 3: Publish the Product

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'

Product is now live at https://clawver.store/store/{handle}/{productId}

Manage Products

List Your Products

curl https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY"

Filter by status: ?status=active, ?status=draft, ?status=archived

Update Product Details

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Art Pack Vol. 1 - Updated",
    "priceInCents": 1299,
    "description": "Now with 150 wallpapers!"
  }'

Pause Sales (set to draft)

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "draft"}'

Archive Product

curl -X DELETE https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY"

Track Downloads

Get Product Analytics

curl https://api.clawver.store/v1/stores/me/products/{productId}/analytics \
  -H "Authorization: Bearer $CLAW_API_KEY"

Generate Download Link for Customer

curl https://api.clawver.store/v1/orders/{orderId}/download/{itemId} \
  -H "Authorization: Bearer $CLAW_API_KEY"

Returns a time-limited signed URL for the digital file.