API Documentation

Quick Start

Publish a site with a single HTTP request. No account or API key required.

# Publish a site in one command
curl -X POST https://yeetit.site/v1/publish \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Hello World</h1>"}'

The response includes a live URL, an edit key for updates, and a claim URL to keep the site permanently.

Authentication

YeetIt supports two authentication methods depending on your use case.

Edit Key

Pass via the X-Edit-Key header. A unique per-site key returned in the publish response. Use it to update or delete that specific site. Anyone with the edit key can modify the site.

API Key

Pass via the X-API-Key header. An account-wide key available from your dashboard after claiming a site. Works for all sites owned by your account.

No authentication is needed for publishing new sites (free tier) or checking site status.

Endpoints

POST /v1/publish

Create a new site. No authentication required.

Request body

Field	Type	Description
`html` required	string	The HTML content of your site
`title` optional	string	Page title (extracted from HTML if omitted)
`assets` optional	object	Map of filename to content (CSS, JS, images)

Response

Field	Description
`url`	Live URL of the published site
`slug`	Unique identifier for the site
`edit_key`	Key for updating or deleting this site
`claim_url`	URL to claim ownership of the site
`expires_at`	ISO 8601 expiration timestamp
`assets_published`	Number of assets stored

# Create a new site
curl -X POST https://yeetit.site/v1/publish \
  -H "Content-Type: application/json" \
  -d '{
  "html": "<h1>Hello World</h1>",
  "title": "My Site"
}'

# Response
{
  "url": "https://yeetit.site/my-site-k3m",
  "slug": "my-site-k3m",
  "edit_key": "ek_9c4d2e7f...",
  "claim_url": "https://yeetit.site/claim/ct_8f3a2b...",
  "expires_at": "2025-02-07T12:00:00Z",
  "assets_published": 0
}

PUT /v1/publish/:slug

Update an existing site. Requires X-Edit-Key or X-API-Key header.

Request body

Field	Type	Description
`html` required	string	Updated HTML content
`title` optional	string	Updated page title
`assets` optional	object	Updated assets map

Response

Field	Description
`url`	Live URL of the site
`slug`	Site identifier
`updated`	`true`
`assets_published`	Number of assets stored

# Update a site
curl -X PUT https://yeetit.site/v1/publish/my-site-k3m \
  -H "Content-Type: application/json" \
  -H "X-Edit-Key: ek_9c4d2e7f..." \
  -d '{
  "html": "<h1>Updated Site</h1>"
}'

# Response
{
  "url": "https://yeetit.site/my-site-k3m",
  "slug": "my-site-k3m",
  "updated": true,
  "assets_published": 0
}

DELETE /v1/publish/:slug

Delete a site. Requires X-Edit-Key or X-API-Key header.

Response

Field	Description
`slug`	Site identifier
`deleted`	`true`

# Delete a site
curl -X DELETE https://yeetit.site/v1/publish/my-site-k3m \
  -H "X-Edit-Key: ek_9c4d2e7f..."

# Response
{
  "slug": "my-site-k3m",
  "deleted": true
}

GET /v1/publish/:slug/status

Get information about a site. No authentication required.

Response

Field	Description
`slug`	Site identifier
`title`	Page title
`tier`	Account tier (free, pro, business)
`views`	Total page views
`html_size`	Size of the HTML content in bytes
`asset_count`	Number of assets
`total_size`	Total size including assets in bytes
`created_at`	ISO 8601 creation timestamp
`expires_at`	ISO 8601 expiration timestamp (null if permanent)
`claimed`	Whether the site has been claimed
`active`	Whether the site is currently live

# Check site status
curl https://yeetit.site/v1/publish/my-site-k3m/status

# Response
{
  "slug": "my-site-k3m",
  "title": "My Site",
  "tier": "free",
  "views": 42,
  "html_size": 1024,
  "asset_count": 2,
  "total_size": 15360,
  "created_at": "2025-01-31T12:00:00Z",
  "expires_at": "2025-02-07T12:00:00Z",
  "claimed": false,
  "active": true
}

Assets

Include CSS, JavaScript, images, and other files alongside your HTML using the assets object.

Text assets

Pass CSS, JS, or any text file as a plain string value in the assets object.

{
  "html": "<link rel=\"stylesheet\" href=\"./style.css\">...",
  "assets": {
    "style.css": "body { font-family: sans-serif; }",
    "app.js": "console.log('hello');"
  }
}

Binary assets

Upload images and other binary files using data URIs.

{
  "html": "<img src=\"./logo.png\">...",
  "assets": {
    "logo.png": "data:image/png;base64,iVBORw0KGgo..."
  }
}

Multi-page sites

Include additional HTML pages as assets. Reference them with relative paths.

{
  "html": "<a href=\"./about.html\">About</a>...",
  "assets": {
    "about.html": "<h1>About Us</h1>...",
    "contact.html": "<h1>Contact</h1>..."
  }
}

Limits

Free tier: 10 assets per site, 5.0MB total (HTML + all assets combined)
Pro / Business: 50 assets per site, 10 MB total (HTML + all assets combined)
Individual assets are capped at 5 MB each

Reference all assets using relative paths: ./style.css, ./images/logo.png

MCP Integration

YeetIt supports the Model Context Protocol for seamless AI agent integration.

Endpoint

Send JSON-RPC 2.0 requests to:

POST https://yeetit.site/mcp

Discovery

MCP-compatible agents can auto-discover available tools at:

GET https://yeetit.site/.well-known/mcp.json

Available tools

publish_website — Create a new site from HTML
update_website — Update an existing site
delete_website — Remove a site
get_website_status — Get site info and metrics

Configuration

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "yeetit": {
      "url": "https://yeetit.site/mcp"
    }
  }
}

Limits

YeetIt is currently in Beta. Free tier includes 5.0MB uploads. Paid plans are coming soon.

	Free	Pro ($8/mo)	Business ($25/mo)
Max size	5.0MB	10 MB	10 MB
Assets	10	50	50
Expiry	24 hours (7 days after claim)	Permanent	Permanent
Active sites	5	25	Unlimited
Footer badge	Yes	No	No
Custom slugs	No	Yes	Yes

Error Codes

All error responses include a JSON body with an error field describing the issue.

Status	Meaning
`400`	Invalid request — missing or malformed fields
`401`	Invalid API key
`403`	Invalid edit key for this site
`404`	Site not found
`409`	Slug already taken
`413`	Content too large
`422`	Content policy violation
`429`	Rate limit exceeded
`500`	Internal server error