Skip to main content

​
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.