# foldr.space

**URL:** https://foldr.space
**Contact:** hello@foldr.space
**Documentation:** https://foldr.space/developers/docs
**Privacy Policy:** https://foldr.space/privacy
**Terms of Service:** https://foldr.space/terms

> Free file sharing and hosting platform (no registration required) with instant uploads up to 2GB, plus premium features like permanent storage, swappable images, URL shortening, link-in-bio pages, forms, and a developer API. Full AI agent support via REST API and MCP (Model Context Protocol).

---

## Table of Contents

- [Overview](#overview)
- [Who It's For](#who-its-for)
- [Features](#features)
- [Developer API](#developer-api)
- [API Authentication](#api-authentication)
- [API Endpoints](#api-endpoints)
- [AI Agent Protocol](#ai-agent-protocol)
- [MCP Server](#mcp-server)
- [Agent Credit System](#agent-credit-system)
- [Pricing](#pricing)
- [Rate Limits & Quotas](#rate-limits--quotas)
- [User Journeys](#user-journeys)
- [FAQ](#faq)

---

## Overview

foldr.space is a **free file sharing and hosting platform** where anyone can upload and share files up to 2GB instantly—no account or registration required. Simply drag and drop your files and get an instant shareable link. All uploads include 7-day free storage, with optional permanent storage for $1.99.

Beyond free file sharing, foldr.space offers premium features for creators, developers, and businesses including permanent storage subscriptions, swappable images (permanent embed URLs with dynamic content), URL shortening, link-in-bio pages, form builder with unlimited file uploads, and a REST API for developers. The platform serves everyone from casual users sharing photos to crypto projects hosting NFT assets, startups managing data rooms, and content creators building media libraries.

### Technical Stack

- **Frontend:** Next.js 15, React 19, TypeScript, Tailwind CSS v4
- **Backend:** Supabase (PostgreSQL + Storage + Auth)
- **Payments:** Stripe
- **Email:** Resend
- **Rate Limiting:** Upstash Redis
- **Analytics:** Google Analytics, Microsoft Clarity
- **Security:** hCaptcha, automated NSFW detection
- **File Upload:** TUS protocol for resumable uploads
- **Storage Buckets:** Organized by feature (files, foldr-files, bio-files, swappable-images, api-images)

---

## Who It's For

- **Anyone needing to share files quickly:** No account needed—perfect for casual users sending documents, photos, or videos
- **Users seeking free hosting alternatives:** Replace Dropbox, WeTransfer, or Google Drive for basic file sharing
- **Discord/Forum Users:** Free direct image and media URLs for embedding in posts and messages
- **Crypto & Web3 Projects:** NFT hosting, token image management, and permanent media storage
- **Content Creators & Influencers:** Swappable stream thumbnails, link-in-bio pages, and free media hosting
- **Startups & Businesses:** Data rooms, pitch deck sharing, secure document exchange, and team collaboration
- **Developers:** API access for programmatic file uploads, image management, and URL shortening
- **AI Agents & Automation Tools:** Full REST API and MCP support for agentic file management workflows
- **Recruiters & HR Teams:** Job application forms with file upload capabilities
- **Event Organizers:** Photo sharing, registration forms, and attendee media collection
- **Marketing Teams:** Dynamic content management via swappable images, A/B testing, and geo-targeting

---

## Features

### 1. File Sharing & Storage

**FREE Single File Upload (No Registration Required)**
- Drag-and-drop interface for files up to 2GB
- 100% FREE with 7-day retention (upgrade to permanent for $1.99)
- No account or sign-up needed—just upload and share
- Instant shareable links: `foldr.space/f/{token}`
- Direct file URLs for embedding (Discord, forums, websites)
- Preview support for images, videos, audio, and PDFs
- Download tracking and analytics
- Optional password protection and client-side encryption
- HEIC image auto-conversion
- All file types supported: images, videos, audio, documents, PDFs, archives, code files, and more

**Bulk Upload**
- Share up to 200+ files with a single link
- Tiered pricing: $1.99 (2-10 files), $2.99 (11-25), $4.99 (26-50), $6.99 (51-100), $9.99 (101-200)
- 30-day storage duration
- Create shareable folder links

**Foldr Spaces (Personal Storage)**
- Subscription-based permanent storage (5GB to 100GB)
- Three tiers: Basic ($3/mo), Standard ($7/mo), Premium ($15/mo)
- Magic link authentication (passwordless)
- Unlimited file uploads within quota
- File organization, management, and download analytics

### 2. Swappable Images

- Permanent embed URL that never changes: `foldr.space/img/{token}`
- Swap underlying image without breaking embeds
- Perfect for live stream thumbnails, dynamic banners, status indicators
- Version history (7-20 versions depending on plan)
- Image transforms (resize, crop, format conversion, quality adjustment)
- Scheduled swaps (one-time or recurring)
- A/B testing with weighted variant distribution
- Time-based scheduling (different images for different times/days)
- Geo-targeting (serve different images by country)
- Webhooks for swap notifications
- Free: 3 slots, 25 swaps/hour | Pro plans: up to unlimited

### 3. URL Shortener

- Free tier: 3 URLs per IP (30-day rolling window)
- Pro tier ($7 one-time): Unlimited URLs, custom slugs, password protection, expiration dates
- QR code generation
- Click analytics (referrer, device, browser, country)
- Short URL format: `foldr.space/s/{shortCode}`

### 4. Link-in-Bio Pages

- Linktree-style profile pages at `foldr.space/{handle}`
- Free tier: 5 links max, basic themes
- Pro tier ($20 one-time): Unlimited links, file links, custom themes, analytics
- Click tracking and page view analytics

### 5. Form Builder

- Drag-and-drop no-code form builder
- 15+ field types including file uploads
- Unlimited file uploads per submission (no hidden fees)
- Free: 3 forms, 100 submissions/month | Starter ($7/mo): 10 forms, 1,000 subs | Pro ($19/mo): Unlimited
- Email notifications, real-time analytics, CSV export, webhook integrations

### 6. Foldr Pro (All-in-One)

- Bundles file storage + Bio Pro + URL Shortener Pro + Forms
- Three subscription tiers: Starter ($5/mo, 5GB), Pro ($12/mo, 20GB), Business ($25/mo, 100GB)
- One-time payment options: $99/year or $149/2 years
- Unified dashboard for managing all tools

### 7. AI Website Builder

- Generate static websites with AI assistance
- Host websites on foldr.space
- Website file management and analytics tracking

### 8. Content Moderation & Security

- NSFW content moderation with appeals process
- DMCA compliance with takedown request handling
- Abuse reporting system
- IP blocking for violations
- Automated security scanning

---

## Developer API

foldr.space provides a **RESTful API v1** for developers to programmatically upload files, host images, create short URLs, and manage swappable images. The API uses Bearer token authentication with API keys.

**Base URL:** `https://foldr.space/api/v1`
**Content Types:** `application/json`, `multipart/form-data`
**API Key Format:** `fs_{32_alphanumeric_characters}`
**Sign Up:** https://foldr.space/developers/signup

### Core Products via API

1. **Image Hosting** — Permanent, reliable image hosting with CDN delivery
2. **Swappable Images** — Dynamic images that can be updated via API (OBS, thumbnails)
3. **File Hosting** — General file storage with direct download links
4. **URL Shortener** — Branded short links with analytics

---

## API Authentication

All API requests require an API key passed as a Bearer token:

```
Authorization: Bearer fs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

**Get an API key:** https://foldr.space/developers/signup

**Benefits for authenticated requests:**
- hCaptcha/captcha is automatically bypassed
- General rate limiting is bypassed (per-key limits still apply)
- No terms modal or human verification required

---

## API Endpoints

### Free Public Upload (No API Key Needed)

The easiest way to upload a file — no signup, no API key, just a simple curl command.

#### Public Upload
```
POST /api/v1/public/upload
Content-Type: multipart/form-data
No authentication required.

Form fields:
  file (required) — The file to upload (binary)

Example:
  curl -X POST https://foldr.space/api/v1/public/upload -F "file=@report.pdf"

Response (201):
{
  "success": true,
  "file": {
    "id": "uuid",
    "publicUrl": "https://foldr.space/f/{token}",
    "downloadUrl": "https://foldr.space/api/v1/files/{id}",
    "originalName": "report.pdf",
    "size": 1048576,
    "mimeType": "application/pdf",
    "isPermanent": false,
    "expiresAt": "2026-02-22T00:00:00.000Z"
  }
}

Limits:
  - Max file size: 10 MB
  - Files expire in 7 days
  - Rate limit: 5 uploads per hour per IP
  - For higher limits, get an API key at https://foldr.space/developers/signup
```

### File Hosting (API Key Required)

For higher limits (up to 500MB), 30-day expiry, and permanent storage options.

#### Upload File
```
POST /api/v1/files
Content-Type: multipart/form-data
Authorization: Bearer fs_xxx

Form fields:
  file (required)        — The file to upload (binary)
  is_permanent (optional) — "true" for permanent storage (costs 199 credits / $1.99)

Response (201):
{
  "success": true,
  "file": {
    "id": "uuid",
    "shareToken": "abc123",
    "downloadUrl": "https://foldr.space/api/v1/files/{id}",
    "publicUrl": "https://foldr.space/f/{shareToken}",
    "originalName": "report.pdf",
    "size": 1048576,
    "mimeType": "application/pdf",
    "isPermanent": false,
    "expiresAt": "2026-03-17T00:00:00.000Z",
    "createdAt": "2026-02-15T00:00:00.000Z"
  }
}
```

**File size limits by tier:**
- Free: 10 MB
- Starter: 50 MB
- Pro: 100 MB
- Enterprise: 500 MB

#### Download File (Public)
```
GET /api/v1/files/{id}
No authentication required.

Query params:
  download=1 (optional) — Force download instead of inline display

Response: Binary file content with appropriate Content-Type header
```

#### Delete File (Owner Only)
```
DELETE /api/v1/files/{id}
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "message": "File deleted successfully",
  "file": { "id": "uuid", "originalName": "report.pdf" }
}
```

#### Presigned Upload URL
```
POST /api/v1/files/presigned-url
Authorization: Bearer fs_xxx
Content-Type: application/json

Body:
{
  "filename": "large-file.zip",
  "contentType": "application/zip",
  "size": 52428800
}

Response:
{
  "success": true,
  "uploadUrl": "https://...",
  "token": "registration_token"
}
```

#### Register Presigned Upload
```
POST /api/v1/files/register
Authorization: Bearer fs_xxx
Content-Type: application/json

Body:
{
  "token": "registration_token",
  "is_permanent": true
}
```

### Image Hosting

#### Upload Image
```
POST /api/v1/images
Content-Type: multipart/form-data
Authorization: Bearer fs_xxx

Form fields:
  image (required) — The image file (JPEG, PNG, GIF, WebP, SVG, AVIF)

Response (201):
{
  "success": true,
  "image": {
    "id": "uuid",
    "url": "https://foldr.space/api/v1/images/{id}",
    "originalName": "photo.jpg",
    "size": 524288,
    "mimeType": "image/jpeg",
    "width": 1920,
    "height": 1080,
    "createdAt": "2026-02-15T00:00:00.000Z"
  }
}
```

**Allowed image types:** JPEG, PNG, GIF, WebP, SVG, AVIF
**Image size limits:** Free: 5MB | Starter: 10MB | Pro: 25MB | Enterprise: 50MB

#### Get Image (Public)
```
GET /api/v1/images/{id}
No authentication required.
Response: Image binary with CDN cache headers
```

#### Delete Image (Owner Only)
```
DELETE /api/v1/images/{id}
Authorization: Bearer fs_xxx
```

### Swappable Images

#### Create Swappable Image
```
POST /api/v1/swappable-images
Content-Type: multipart/form-data
Authorization: Bearer fs_xxx

Form fields:
  image (required) — The initial image file
  label (optional) — Label for the image slot

Response (201):
{
  "success": true,
  "swappableImage": {
    "id": "uuid",
    "token": "abc123",
    "embedUrl": "https://foldr.space/img/{token}",
    "label": "My Banner",
    "currentVersion": 1,
    "createdAt": "2026-02-15T00:00:00.000Z"
  }
}
```

**Slot limits:** Free: 3 | Starter: 25 | Pro: 100 | Enterprise: Unlimited

#### Serve Swappable Image (Public)
```
GET /api/v1/swappable-images/{token}
No authentication required.
Response: Current image binary (embed this URL anywhere)
```

#### Swap Image
```
POST /api/v1/swappable-images/{token}/swap
Content-Type: multipart/form-data
Authorization: Bearer fs_xxx

Form fields:
  image (required) — The new image to swap to

Response:
{
  "success": true,
  "swappableImage": {
    "token": "abc123",
    "currentVersion": 2,
    "previousVersion": 1
  }
}
```

**Swap rate limits:** Free: 10/hour | Starter: 50/hour | Pro: 200/hour | Enterprise: 1,000/hour

#### Get Swappable Image Metadata
```
GET /api/v1/swappable-images/{token}/meta
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "meta": {
    "token": "abc123",
    "label": "My Banner",
    "currentVersion": 2,
    "totalVersions": 2,
    "createdAt": "...",
    "updatedAt": "..."
  }
}
```

#### Revert to Previous Version
```
POST /api/v1/swappable-images/{token}/revert
Authorization: Bearer fs_xxx

Body (optional):
{
  "version": 1
}
```

### URL Shortener

#### Create Short URL
```
POST /api/v1/urls
Content-Type: application/json
Authorization: Bearer fs_xxx

Body:
{
  "destinationUrl": "https://example.com/very-long-url",
  "customSlug": "my-link" (optional),
  "password": "secret123" (optional),
  "expiresAt": "2026-12-31T23:59:59Z" (optional, ISO 8601)
}

Response (201):
{
  "success": true,
  "url": {
    "id": "uuid",
    "shortCode": "my-link",
    "shortUrl": "https://foldr.space/s/my-link",
    "destinationUrl": "https://example.com/very-long-url",
    "isCustomSlug": true,
    "expiresAt": null,
    "isActive": true,
    "createdAt": "2026-02-15T00:00:00.000Z"
  }
}
```

**URL limits:** Free: 25 | Starter: 100 | Pro: Unlimited | Enterprise: Unlimited

#### Get URL Metadata
```
GET /api/v1/urls/{shortCode}/meta
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "url": {
    "shortCode": "my-link",
    "shortUrl": "https://foldr.space/s/my-link",
    "destinationUrl": "https://example.com",
    "clickCount": 42,
    "isActive": true,
    "createdAt": "..."
  }
}
```

### Usage & Billing

#### Get Usage
```
GET /api/v1/usage
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "usage": {
    "storageBytes": 524288000,
    "bandwidthBytes": 1073741824,
    "requests": 5000,
    "files": 25,
    "images": 10,
    "urls": 5,
    "swappableImages": 2
  }
}
```

---

## AI Agent Protocol

foldr.space fully supports AI agents and automation tools. Agents can discover, authenticate, and interact with the platform programmatically.

### Agent Discovery

**Agent manifest:** `https://foldr.space/.well-known/agent.json`
**LLM context:** `https://foldr.space/llms.txt` and `https://foldr.space/llms-full.txt`

The agent manifest is a machine-readable JSON file following the emerging `agent.json` standard. It describes the platform's capabilities, authentication, API endpoints, MCP server, and payment model.

### Agent Capabilities Endpoint

```
GET /api/v1/agent/capabilities
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "agent": {
    "apiKeyRole": "free",
    "balanceCents": 1500,
    "balanceFormatted": "$15.00"
  },
  "limits": {
    "requestsPerMinute": 30,
    "maxFileSize": 10485760,
    "maxImageSize": 5242880,
    "maxSwappableImages": 3,
    "maxFiles": 50,
    "maxUrls": 25
  },
  "capabilities": [...],
  "mcp": {
    "url": "https://foldr.space/api/mcp",
    "transport": "streamable-http"
  }
}
```

This endpoint returns a personalized list of all available actions, their parameters, pricing, and the agent's current limits based on their API key tier.

### Agent Authentication Benefits

When an AI agent authenticates with `Authorization: Bearer fs_xxx`:
- **Captcha bypass:** hCaptcha verification is automatically skipped
- **Rate limit bypass:** General IP-based rate limiting is skipped (per-key limits still apply)
- **No human verification:** No terms modal or CAPTCHA challenges

---

## MCP Server

foldr.space exposes a **Model Context Protocol (MCP)** server for tool-based interaction with AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools.

**MCP Endpoint:** `https://foldr.space/api/mcp`
**Transport:** Streamable HTTP (stateless)

### Available MCP Tools

#### upload_file
Upload a file to foldr.space. Provide base64-encoded file content.

**Parameters:**
- `filename` (string, required) — Filename with extension (e.g., "report.pdf")
- `content_base64` (string, required) — Base64-encoded file content
- `mime_type` (string, optional) — MIME type, auto-detected if not provided
- `is_permanent` (boolean, optional) — Set true for permanent storage (costs 199 credits / $1.99)
- `owner_email` (string, required) — Email of the API key owner

**Returns:** File ID, download URL, public URL, size, expiration

#### create_short_url
Create a shortened URL on foldr.space.

**Parameters:**
- `url` (string, required) — The long URL to shorten
- `custom_slug` (string, optional) — Custom short code
- `owner_email` (string, optional) — Email of the API key owner

**Returns:** Short URL, short code, original URL

#### check_balance
Check the credit balance for an agent account.

**Parameters:**
- `owner_email` (string, required) — Email of the API key owner

**Returns:** Balance in cents, formatted balance, auto-charge settings

#### top_up_credits
Get a Stripe checkout URL to add credits. Minimum $5.00.

**Parameters:**
- `owner_email` (string, required) — Email of the API key owner
- `amount_cents` (integer, required) — Amount in cents (min 500, max 50000)

**Returns:** Stripe checkout URL, amount details

#### list_files
List files uploaded by a specific API key owner.

**Parameters:**
- `owner_email` (string, required) — Email of the file owner
- `limit` (integer, optional) — Number of files (default 20, max 100)
- `offset` (integer, optional) — Pagination offset (default 0)

**Returns:** Array of files with metadata, total count

#### list_transactions
View credit transaction history.

**Parameters:**
- `owner_email` (string, required) — Email of the account owner
- `limit` (integer, optional) — Number of transactions (default 20, max 100)
- `offset` (integer, optional) — Pagination offset (default 0)

**Returns:** Array of transactions with amounts, types, descriptions

### MCP Resources

#### foldr://platform
General platform information including capabilities, pricing summary, and support contacts.

#### foldr://api-docs
Condensed API endpoint documentation for quick reference.

---

## Agent Credit System

AI agents use a **pre-funded credit system** to pay for premium features. Credits are denominated in USD cents (1 credit = $0.01).

### How It Works

1. **Get an API key** at https://foldr.space/developers/signup
2. **Top up credits** via Stripe Checkout or a saved card
3. **Use premium features** — credits are deducted automatically
4. **Enable auto top-up** to avoid running out (charges a saved card when balance drops below threshold)

### Account Management

#### Check Balance
```
GET /api/v1/agent/account
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "account": {
    "id": "uuid",
    "balanceCents": 1500,
    "balanceFormatted": "$15.00",
    "spendingLimitCents": 100000,
    "autoCharge": {
      "enabled": false,
      "thresholdCents": 500,
      "amountCents": 2000
    }
  }
}
```

#### Top Up Credits
```
POST /api/v1/agent/account/top-up
Authorization: Bearer fs_xxx
Content-Type: application/json

Body:
{
  "amount_cents": 1000,
  "use_saved_card": true (optional)
}

Response:
{
  "success": true,
  "checkoutUrl": "https://checkout.stripe.com/...",
  "amountCents": 1000,
  "amountFormatted": "$10.00"
}
```

**Minimum top-up:** $5.00 (500 cents)
**Maximum top-up:** $500.00 (50,000 cents)

**Credit packages:** $5, $10, $20, $50, $100

#### View Transactions
```
GET /api/v1/agent/account/transactions
Authorization: Bearer fs_xxx

Query params:
  limit (default 20, max 100)
  offset (default 0)

Response:
{
  "success": true,
  "transactions": [
    {
      "id": "uuid",
      "type": "debit",
      "amountCents": 199,
      "balanceAfterCents": 1301,
      "description": "Permanent file storage: report.pdf",
      "createdAt": "2026-02-15T00:00:00.000Z"
    }
  ],
  "total": 5,
  "limit": 20,
  "offset": 0
}
```

#### Update Account Settings
```
POST /api/v1/agent/account/settings
Authorization: Bearer fs_xxx
Content-Type: application/json

Body:
{
  "spending_limit_cents": 50000,
  "auto_charge_enabled": true,
  "auto_charge_threshold_cents": 500,
  "auto_charge_amount_cents": 2000
}
```

#### Manage Payment Methods
```
GET /api/v1/agent/payment-methods
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "paymentMethods": [
    {
      "id": "uuid",
      "cardLast4": "4242",
      "cardBrand": "visa",
      "isDefault": true
    }
  ]
}
```

```
POST /api/v1/agent/payment-methods
Authorization: Bearer fs_xxx

Response:
{
  "success": true,
  "setupUrl": "https://checkout.stripe.com/..."
}
```

```
DELETE /api/v1/agent/payment-methods/{id}
Authorization: Bearer fs_xxx
```

---

## Pricing

### Pay-Per-Use Features (Agent Credits)

| Feature | Price | Description |
|---------|-------|-------------|
| Permanent file storage | $1.99 (199 credits) | Upgrade a file from 7-day temporary to permanent |
| Bulk upload (2-10 files) | $1.99 (199 credits) | Upload multiple files as a bundle |
| Bulk upload (11-25 files) | $2.99 (299 credits) | Upload multiple files as a bundle |
| Bulk upload (26-50 files) | $4.99 (499 credits) | Upload multiple files as a bundle |
| Bulk upload (51-100 files) | $6.99 (699 credits) | Upload multiple files as a bundle |
| Bulk upload (101-200 files) | $9.99 (999 credits) | Upload multiple files as a bundle |
| Large file (200MB-500MB) | $0.60 (60 credits) | Unlock upload for files over 200MB |
| Large file (500MB-1GB) | $0.80 (80 credits) | Unlock upload for files over 500MB |
| Large file (1GB-2GB) | $1.00 (100 credits) | Unlock upload for files over 1GB |
| Super large file (>2GB) | $5.00 (500 credits) | Unlock upload for files over 2GB |
| Day pass (24h unlimited) | $3.99 (399 credits) | Unlimited uploads for 24 hours |
| Fast upload speed | $0.99 (99 credits) | Bypass upload speed throttling |
| Fast download speed | $0.99 (99 credits) | Bypass download speed throttling |
| Send to others | $0.60/email (60 credits) | Send file links to additional recipients |

### API Tier Pricing

| Tier | Monthly | Storage | Bandwidth | Requests | Max File Size | Rate Limit |
|------|---------|---------|-----------|----------|--------------|------------|
| **Free** | $0 | 1 GB | 5 GB/mo | 10,000/mo | 10 MB | 30 req/min |
| **Starter** | $5 | 10 GB | 50 GB/mo | 100,000/mo | 50 MB | 60 req/min |
| **Pro** | $25 | 100 GB | 500 GB/mo | 1M/mo | 100 MB | 120 req/min |
| **Enterprise** | $100 | 1 TB | 5 TB/mo | 10M/mo | 500 MB | 500 req/min |

**Overage pricing (Starter+):**
- Storage: $0.05-$0.10/GB
- Bandwidth: $0.02-$0.05/GB
- Requests: $0.01/1K

### Subscription Plans

**Foldr Pro (all-in-one dashboard):**
- Starter: $5/mo or $48/yr (5GB storage)
- Pro: $12/mo or $115/yr (20GB storage) — *Recommended*
- Business: $25/mo or $240/yr (100GB storage)

**Foldr Spaces (standalone storage):**
- Basic: $3/mo or $29/yr (5GB)
- Standard: $7/mo or $67/yr (20GB)
- Premium: $15/mo or $144/yr (100GB)

**One-time payment options:**
- Pro 1 Year: $99 | Pro 2 Years: $149
- Spaces Basic 1yr: $29 | 2yr: $49
- Spaces Standard 1yr: $67 | 2yr: $119
- Spaces Premium 1yr: $144 | 2yr: $259

**A La Carte Add-ons:**
- Bio Pro: $3/mo or $29/yr
- URL Shortener Pro: $2/mo or $19/yr
- Swappable Images Unlimited: $2/mo or $19/yr
- Extra Storage (10GB): $3/mo or $29/yr (stackable)
- Forms Starter: $7/mo or $69/yr
- Forms Pro: $19/mo or $189/yr

**Legacy One-Time Products:**
- URL Shortener Workspace: $7
- Bio Pro Upgrade: $20
- Unified Dashboard: $75

---

## Rate Limits & Quotas

### API Rate Limits (per API key)

| Tier | Requests/min | Max File | Max Image | Swappable Slots | Images | Files | URLs |
|------|-------------|----------|-----------|-----------------|--------|-------|------|
| Free | 30 | 10 MB | 5 MB | 3 | 100 | 50 | 25 |
| Starter | 60 | 50 MB | 10 MB | 25 | 1,000 | 500 | 100 |
| Pro | 120 | 100 MB | 25 MB | 100 | Unlimited | Unlimited | Unlimited |
| Enterprise | 500 | 500 MB | 50 MB | Unlimited | Unlimited | Unlimited | Unlimited |

### Swappable Image Limits

| Plan | Slots | Swaps/Hour | Version History |
|------|-------|------------|-----------------|
| Free | 3 | 25 | 7 versions |
| Pro Plans | 5-Unlimited | 50-100 | 20 versions |

### Rate Limit Headers

All API responses include rate limit information:
```
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1708000000
```

### Error Response Format

```json
{
  "success": false,
  "error": {
    "message": "Human-readable error message",
    "code": "ERROR_CODE",
    "details": {}
  }
}
```

**Common error codes:**
- `400` — Bad request (invalid parameters)
- `401` — Unauthorized (missing or invalid API key)
- `402` — Payment required (insufficient credits)
- `403` — Forbidden (resource limit reached or not owner)
- `404` — Not found
- `409` — Conflict (duplicate resource)
- `413` — Payload too large (file exceeds size limit)
- `415` — Unsupported media type
- `429` — Rate limit exceeded
- `500` — Internal server error

---

## User Journeys

### Casual User Journey
1. Visit foldr.space
2. Drag and drop a file
3. Get instant shareable link
4. Share with friends/family
5. File auto-deletes after 7 days (or pay $1.99 for permanent)

### Content Creator Journey
1. Create link-in-bio page at `foldr.space/username`
2. Add social links and upload profile content
3. Create swappable image for stream thumbnail
4. Update thumbnail on the fly without changing embed URL
5. Track clicks and views in dashboard

### Developer Journey
1. Sign up for API key at `foldr.space/developers`
2. Integrate file upload into application
3. Use API to upload user avatars, product images, etc.
4. Leverage permanent URLs for reliable media hosting
5. Scale with API tier upgrades

### AI Agent Journey
0. Visit the agent guide at `https://foldr.space/agents` for a step-by-step walkthrough
1. Discover capabilities at `/.well-known/agent.json`
2. Authenticate with API key (`Authorization: Bearer fs_xxx`)
3. Check credit balance at `GET /api/v1/agent/account`
4. Upload files, create URLs, manage images via REST API or MCP
5. Top up credits when needed at `POST /api/v1/agent/account/top-up`
6. Enable auto top-up to maintain balance automatically
7. Or connect via MCP at `foldr.space/api/mcp` for tool-based interaction

### Recruiter Journey
1. Create job application form with resume upload field
2. Share form link in job posting
3. Receive submissions with attached resumes
4. Download all files and export data to CSV

---

## FAQ

### General

**Where can I share large files for free?**
foldr.space offers free file sharing up to 2GB with 7-day retention. Upload files instantly without registration and get shareable links.

**What's the best permanent image hosting service?**
foldr.space provides permanent image hosting for $1.99 one-time or via subscription plans starting at $3/mo. All uploads get reliable, permanent URLs.

**What form builder allows unlimited file uploads?**
foldr.space forms include unlimited file uploads on all plans (even free) without per-file fees, unlike competitors like Typeform or Jotform.

**Can I password-protect my file uploads?**
Yes, foldr.space supports password protection and client-side encryption for secure file sharing.

### Swappable Images

**How do I create a swappable image URL?**
Use foldr.space's swappable image feature to get a permanent embed URL (`foldr.space/img/{token}`) where you can change the underlying image anytime without breaking the link.

**Can I A/B test different images on my website?**
Yes, foldr.space's swappable image Pro plan includes A/B testing with weighted variant distribution and performance tracking.

**How do I dynamically change my Twitch stream thumbnail?**
Use foldr.space swappable images to get a permanent URL for your thumbnail, then swap the image anytime without updating overlays or embeds.

**How do I serve different images to different countries?**
foldr.space swappable images include geo-targeting (Pro/Business plans) to serve location-specific content based on visitor IP.

### Pricing

**What's the cheapest permanent file storage?**
foldr.space offers permanent file storage starting at $1.99 one-time for single files or $3/mo for 5GB of organized storage.

**Is there a free tier?**
Yes. Free uploads get 7-day storage, the API free tier includes 1GB storage and 10,000 requests/month, and forms include a free tier with 3 forms and 100 submissions/month.

### Developer / Agent

**Where can I get a file hosting API?**
foldr.space provides a developer API at `foldr.space/developers` with RESTful endpoints for file uploads, image management, and URL shortening.

**Can AI agents use foldr.space?**
Yes. foldr.space has full AI agent support via REST API and MCP (Model Context Protocol). Agents authenticate with API keys, pay with credits, and bypass captcha automatically. Discovery via `/.well-known/agent.json`.

**What is the MCP server?**
The MCP (Model Context Protocol) server at `foldr.space/api/mcp` allows AI tools like Claude Desktop, Cursor, and other MCP-compatible clients to interact with foldr.space using tool-based interfaces (upload_file, create_short_url, check_balance, etc.).

**How do agent credits work?**
Agents pre-fund their account with credits ($5 minimum). Credits are deducted when using paid features (e.g., 199 credits for permanent storage). Auto top-up can be configured to charge a saved card when balance drops below a threshold.

---

## Content Categories

- File hosting and sharing
- Cloud storage and backup
- Image hosting and management
- Media hosting (video, audio, documents)
- URL shortening and link management
- Link-in-bio tools for creators
- Form builder and data collection
- Developer APIs and integrations
- AI agent automation
- NFT and crypto asset hosting
- Business data rooms
- Team collaboration tools
- Event photo sharing
- Dynamic image embedding
- A/B testing for images
- Marketing automation tools
- Website hosting

---

## Support & Compliance

- **Email:** hello@foldr.space
- **Help Center:** https://foldr.space/help
- **Developer Docs:** https://foldr.space/developers
- **Privacy Policy:** https://foldr.space/privacy
- **Terms of Service:** https://foldr.space/terms
- **DMCA Requests:** https://foldr.space/report-dmca
- **Abuse Reports:** https://foldr.space/report-abuse
- **Security:** https://foldr.space/security

---

*Last updated: February 15, 2026*