Agent Tooling

Deploy Static Site

One API call deploys a complete static website — storage bucket, file uploads, CDN, domain, SSL, and DNS.

What It Does

The deploy/static-site endpoint orchestrates five services in one call:

Storage — Creates a bucket (named after the project)

Upload — Uploads files (from request body or cloned from git)

CDN — Creates a deployment with the bucket as origin

Domain — Adds your domain to the CDN with automatic SSL

DNS — Auto-creates CNAME record if the zone is on Edge DNS

Request

POST /agent/deploy/static-site
Authorization: Bearer ea_live_...

{
  "project": "my-portfolio",
  "source": {
    "type": "upload",
    "files": [
      {
        "path": "index.html",
        "content": "PCFET0NUWVBFIGh0bWw+Li4=",
        "content_type": "text/html"
      },
      {
        "path": "styles.css",
        "content": "Ym9keSB7IG1hcmdpbjogMDsgfQ==",
        "content_type": "text/css"
      },
      {
        "path": "app.js",
        "content": "Y29uc29sZS5sb2coJ2hlbGxvJyk=",
        "content_type": "application/javascript"
      }
    ]
  },
  "domain": "portfolio.example.com"
}

Deploy from Git

Instead of uploading files directly, you can deploy from a GitHub or GitLab repository. The agent clones the repo and deploys the specified directory.

POST /agent/deploy/static-site
Authorization: Bearer ea_live_...

{
  "project": "my-portfolio",
  "source": {
    "type": "git",
    "repo": "user/my-portfolio",
    "branch": "main",
    "path": "dist"
  },
  "domain": "portfolio.example.com"
}

Use the path parameter to specify a subdirectory (e.g. dist or build) — only that directory will be deployed.

Private Repositories

For private repositories, include a personal access token:

{
  "source": {
    "type": "git",
    "repo": "user/private-site",
    "branch": "main",
    "path": "build",
    "token": "ghp_xxxxxxxxxxxx"
  }
}

Parameters

Field	Required	Description
project	Yes	Project name. Created automatically if it doesn't exist.
source.type	Yes	`"upload"` for base64 files, `"git"` to deploy from a repository
source.files[]	Required for type 'upload'	Array of files. Each needs `path` and `content` (base64).
source.files[].content_type	No	MIME type. Auto-detected from file extension if omitted.
source.repo	For git	GitHub/GitLab URL or `user/repo` shorthand
source.branch	For git	Branch or tag. Default: main
source.path	For git	Subdirectory to deploy (e.g. "dist", "build"). Root if omitted.
source.token	For git	Personal access token for private repositories
source.changed_only	No	Skip unchanged files on update (compares MD5 hashes)
domain	No	Domain to serve from. SSL provisioned automatically.
options.spa_mode	No	Enable single-page app mode (route all paths to index.html).
options.image_optimization	No	Enable on-the-fly image optimization via CDN.

Response

{
  "status": "deployed",
  "project_id": "proj_a1b2c3d4e5f6",
  "url": "https://portfolio.example.com",
  "resources_created": [
    { "type": "storage_bucket", "id": "my-portfolio", "name": "my-portfolio" },
    { "type": "cdn_deployment", "id": "dep_xyz789", "name": "my-portfolio" },
    { "type": "dns_record", "id": "zone_abc", "note": "CNAME portfolio → cdn.edge.network" }
  ],
  "tell_user": "Your site is live at https://portfolio.example.com. 3 files deployed to Edge CDN with automatic SSL."
}

Dry Run

Add X-Dry-Run: true to preview what would be created:

POST /agent/deploy/static-site
Authorization: Bearer ea_live_...
X-Dry-Run: true

# Response:
{
  "dry_run": true,
  "would_create": [
    { "type": "storage_bucket", "name": "my-portfolio" },
    { "type": "cdn_deployment", "name": "my-portfolio" },
    { "type": "cdn_domain", "domain": "portfolio.example.com" },
    { "type": "dns_record", "note": "CNAME → cdn.edge.network (if zone on Edge DNS)" }
  ],
  "file_count": 3,
  "tell_user": "Would create storage bucket, upload 3 files, and configure CDN. Domain portfolio.example.com would be added with SSL."
}

Updating a Deployment

After the initial deploy, use PATCH /agent/deploy/{projectId} to push updates without recreating resources:

PATCH /agent/deploy/proj_a1b2c3d4e5f6
Authorization: Bearer ea_live_...

{
  "source": {
    "type": "upload",
    "files": [
      { "path": "index.html", "content": "PCFET0NUWVBFIGh0bWw+Li4=", "content_type": "text/html" }
    ]
  },
  "purge_cdn": true
}

# Response:
{
  "project": "my-portfolio",
  "files_uploaded": 1,
  "cdn_purged": true,
  "tell_user": "Updated \"my-portfolio\": 1 file uploaded. CDN cache purged."
}

Incremental Updates

Set changed_only: true to skip uploading files that haven't changed. The agent compares MD5 hashes of each file against the existing deployment and only uploads differences.

PATCH /agent/deploy/proj_a1b2c3d4e5f6
Authorization: Bearer ea_live_...

{
  "source": {
    "type": "upload",
    "files": [...],
    "changed_only": true
  },
  "purge_cdn": true
}

# Response:
{
  "project": "my-portfolio",
  "files_uploaded": 3,
  "files_skipped": 47,
  "cdn_purged": true,
  "tell_user": "Updated \"my-portfolio\": 3 files uploaded. 47 unchanged files skipped. CDN cache purged."
}

Auto-Detected Content Types

If content_type is omitted, it's detected from the file extension:

.html → text/html

.css → text/css

.js → application/javascript

.json → application/json

.png → image/png

.jpg → image/jpeg

.svg → image/svg+xml

.webp → image/webp

.woff2 → font/woff2

.mp4 → video/mp4

.pdf → application/pdf

.xml → application/xml