Flux Pass user API: avatars, domains, subscriptions

{
  "message": "Avatar not found"
}

{
  "avatar": "cuid_abc123/avatar_1717596600.png",
  "message": "Avatar uploaded successfully"
}

{
  "message": "File too large. Maximum size is 2MB"
}

{
  "message": "Avatar deleted successfully"
}

{
  "customDomain": "files.example.com",
  "customDomainVerified": true,
  "hasCustomDomain": true
}

{
  "message": "Enterprise plan required for custom domains"
}

{
  "success": true,
  "domain": "files.example.com",
  "message": "Domain connected successfully. Please configure your DNS settings."
}

{
  "message": "Domain is already in use"
}

{
  "success": true,
  "message": "Custom domain disconnected successfully"
}

{
  "entitlements": [
    {
      "id": "ent_abc123",
      "userId": "cuid_abc123",
      "service": "DROP",
      "tier": "pro",
      "isPremium": true,
      "connected": true,
      "customStorageLimit": null,
      "customApiKeyLimit": null,
      "metadata": {},
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-06-05T14:30:00.000Z"
    }
  ]
}

{
  "entitlement": {
    "id": "ent_abc123",
    "service": "DROP",
    "tier": "pro",
    "isPremium": true,
    ...
  }
}

{
  "id": "sub_polar_123",
  "status": "active",
  "currentPeriodStart": 1717200000,
  "currentPeriodEnd": 1719792000,
  "cancelAtPeriodEnd": false,
  "plan": "pro",
  "billingCycle": "monthly",
  "price": {
    "amount": 39.96,
    "currency": "pln",
    "interval": "month"
  },
  "product": {
    "name": "Premium"
  }
}

{
  "message": "No active subscription"
}