Verify Cloudflare Pages build status

After create_astro_route or update_astro_route pushes a commit to GitHub, Cloudflare Pages auto-builds in 30–90 seconds. The check_astro_deploy tool queries the Cloudflare Pages API to confirm success.

Prerequisites: see astro prerequisites for the full setup checklist (site registration, plugins, token scope).

Tool call

check_astro_deploy
  site_id="<astro-site-id>"
  commit_sha="<commit-hash-from-create-or-update>"   // optional — defaults to latest deployment

Output examples

Success:

{
  "status": "success",
  "stage": "deploy",
  "url": "https://my-astro-site.pages.dev",
  "preview_url": "https://abc123.my-astro-site.pages.dev",
  "log_url": "https://dash.cloudflare.com/<account>/pages/view/my-astro-site/<deploy>",
  "deployment_id": "abc-123",
  "commit_sha": "<hash>",
  "branch": "main",
  "stages": [
    { "name": "queued", "status": "success" },
    { "name": "initialize", "status": "success" },
    { "name": "clone_repo", "status": "success" },
    { "name": "build", "status": "success" },
    { "name": "deploy", "status": "success" }
  ]
}

Failure:

{
  "status": "failure",
  "stage": "build",
  "log_url": "https://dash.cloudflare.com/<account>/pages/view/my-astro-site/<deploy>",
  "stages": [
    { "name": "build", "status": "failure" }
  ]
}

Click log_url in the Cloudflare dashboard to see the build log line by line.

Not found (commit not yet picked up by CF):

{
  "status": "not_found",
  "message": "No deployment matching commit <sha> yet. Cloudflare may not have picked up the push (try again in 10-30 seconds)..."
}

When to poll

• Right after create_astro_route: wait 15s, then poll until success or failure
• Time-out around 5 minutes — most builds finish in 30-90s, but a cold cache or large dependency install can take up to 3 minutes
• Don’t poll without a commit_sha — you might catch an unrelated older deployment

When this tool isn’t available

If you set up Astro without CF secrets, you can still use the Cloudflare dashboard manually: open Workers & Pages → your project → Deployments. Or configure the secrets later and re-load Claude’s tool list.