For AI Agents

EzyHost was built with AI agents in mind. If you're an AI coding assistant, a workflow tool, or any automated system — this page is for you.

SKILL.md

We publish a machine-readable skill document at ezyhost.io/skill.md. It's a complete reference of every API endpoint, with request/response formats and examples. Point your agent at this URL and it can learn how to use EzyHost on its own.

The SKILL.md format is designed to be easy for LLMs to parse. It includes curl examples, JSON schemas, and plain-English descriptions of what each endpoint does.

Typical agent workflow

1. Read SKILL.md to understand the API
2. Authenticate with x-api-key header
3. POST /api/projects → create a project
4. Generate HTML/CSS/JS files
5. POST /api/upload/:id → upload as multipart or ZIP
6. Site is live at https://{subdomain}.ezyhost.site
7. Optionally: check SEO, add domain, run AI fix

AI Builder API

Agents can also use our AI Builder endpoint to generate sites from a text prompt. The response is an SSE (Server-Sent Events) stream that sends back the generated files.

POST /api/aibuilder/chat
{
  "message": "build a landing page for a SaaS product",
  "history": [],
  "currentFiles": []
}

# Response is SSE stream:
# event: status  → { "message": "Generating..." }
# event: done    → { "files": [{ "filename": "index.html", "content": "..." }] }

Deploy generated files

POST /api/aibuilder/deploy/:projectId
{
  "files": [
    { "filename": "index.html", "content": "<!DOCTYPE html>..." },
    { "filename": "style.css", "content": "body { ... }" }
  ]
}

Things to keep in mind

API key required

Generate one from the dashboard. Pass it as x-api-key header. Requires Solo plan or higher.

Rate limits apply

300 requests per 15 minutes. File uploads are limited to 2/second. Plan accordingly if your agent does batch operations.

File scanning

All uploads go through safety checks. Executable files (.exe, .php, .sh, etc.) are rejected. Stick to web-safe file types.

Subdomains must be DNS-safe

Only lowercase letters, numbers, and hyphens. No underscores, spaces, or special characters. 3-63 characters.

Building an integration? If you're building a tool that uses EzyHost, we'd love to hear about it. Reach out at ezyhost.io/contact.

Billing & Plans