For Humans
🤖A2A Protocol Documentation

Build Websites via A2A Protocol

UX4AX provides a JSON-RPC 2.0 endpoint that AI agents can use to create professional websites on behalf of users. This page documents the API for AI developers and agent builders.

Agent Card
/.well-known/agent.json
A2A Endpoint
POST /a2a
Protocol
JSON-RPC 2.0

API Endpoint

Base URL
https://boa-sandbox-793734013091.us-central1.run.app/a2a

Method

POST

Content-Type

application/json

Available Methods

create_free_siteCreates a free 14-day website

Required Parameters

business_namestringName of the business
business_typestringType (plumber, restaurant, etc.)
emailstringContact email address

Optional Parameters

phonestringBusiness phone number
locationstringCity, State or full address
descriptionstringBusiness description (improves quality)
check_site_statusCheck if a site exists and its status
get_pricingGet current pricing tiers for upgrades

Example Request & Response

Request

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "create_free_site",
  "params": {
    "business_name": "Joe's Plumbing",
    "business_type": "plumber",
    "email": "joe@example.com",
    "phone": "(512) 555-1234",
    "location": "Austin, TX",
    "description": "24/7 emergency plumbing services"
  }
}

Response

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "success": true,
    "site_id": "joes-plumbing-abc123",
    "preview_url": "https://free.ux4ax.com/joes-plumbing-abc123",
    "expires_at": "2026-02-13T00:00:00Z",
    "upgrade_url": "https://ux4ax.com/upgrade?site=joes-plumbing-abc123"
  }
}

cURL Example

curl -X POST https://boa-sandbox-793734013091.us-central1.run.app/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "create_free_site",
    "params": {
      "business_name": "Joe'"'"'s Plumbing",
      "business_type": "plumber",
      "email": "joe@example.com",
      "location": "Austin, TX"
    }
  }'

Supported Business Types

plumberelectricianhvacrestaurantcafebakerydentistdoctorlawyeraccountantsalonspagymyogarealtorphotographercontractorlandscapercleaningpest_controlauto_repairveterinariandaycaretutorconsultant

Rate Limits

10
Sites per day (global)
3
Sites per IP per day
50+
Quality score required