Quickstart - ShareSame Docs

Step 1: Get your base URL and API key

ShareSame gives your team:

a base URL
a Bearer API key
any rollout notes for your account

For the examples below, assume you exported both values:

export SHARESAME_BASE_URL="https://your-base-url-from-sharesame/api/sharesame"
export SHARESAME_API_KEY="your_api_key"

Step 2: Start a website job

curl -X POST "$SHARESAME_BASE_URL/generate" \
  -H "Authorization: Bearer $SHARESAME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "build me a CRM like Salesforce but call it ForceSale",
    "user_id": "acct_123",
    "project_id": "project_123"
  }'

Typical response:

{
  "status": "building",
  "job_id": "c71f4f25-1d65-48e0-a5fb-8cdf7dbbd694",
  "error": "",
  "source": "generated",
  "search_score": 0,
  "sandbox_session": "",
  "cached_files": []
}

Step 3: Poll until the job is ready

curl "$SHARESAME_BASE_URL/job/c71f4f25-1d65-48e0-a5fb-8cdf7dbbd694" \
  -H "Authorization: Bearer $SHARESAME_API_KEY"

When the job finishes, you get a response like this:

{
  "status": "ready",
  "files": [
    {
      "path": "index.html",
      "content": "<!DOCTYPE html>...",
      "language": "html"
    }
  ],
  "error": "",
  "progress": "",
  "elapsed_seconds": 19,
  "sandbox_session": "codex-sandbox",
  "deployment_id": ""
}

Step 4: Deploy the returned files

Take the files array and write each file to disk, object storage, or whatever build step your AI already uses. ShareSame does not force a deployment platform. You can ship the output on Cloudflare, Vercel, Netlify, or your own infrastructure.

If you want to keep related edits together, reuse the same project_id on later requests.

Step 5: Report the final public URL

After your deployment goes live, report it back:

curl -X POST "$SHARESAME_BASE_URL/job/c71f4f25-1d65-48e0-a5fb-8cdf7dbbd694/deployed" \
  -H "Authorization: Bearer $SHARESAME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deploy_url": "https://forcesale.example.com"
  }'

Auth details

See the exact header format and optional tracking fields.

Job states

Learn how building, partial, ready, and failed behave.

​Step 1: Get your base URL and API key

​Step 2: Start a website job

​Step 3: Poll until the job is ready

​Step 4: Deploy the returned files

​Step 5: Report the final public URL

Auth details

Job states

Step 1: Get your base URL and API key

Step 2: Start a website job

Step 3: Poll until the job is ready

Step 4: Deploy the returned files

Step 5: Report the final public URL