Deploy a block as an HTTP endpoint
deploy_endpointPublishes a workspace block as a live HTTP API endpoint or site page in a domain; preview first, then confirm to deploy, with isAnonymous for public access.
Instructions
Publishes a workspace's block as a live HTTP API endpoint — or a page of a site — in the given domain. Powerful: requires confirm=true — first call WITHOUT confirm to preview, then again with confirm:true. Anything meant to be publicly reachable needs isAnonymous:true.
An endpoint serves the workspace AUTO-SAVE — the canvas, live — under the version label "head". Editing a block changes what the URL answers immediately: no redeploy, and committing does not freeze it. That is the OPPOSITE of create_schedule, which pins a committed version and keeps running it, so one block can serve new code over HTTP while a cron on the same block still runs the old one. Name which of the two you mean whenever a user asks why a change "did not take". (commit_workspace_version does archive a copy of each deployed path at its own version label, but those copies are created disabled — nothing changes at the live URL.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspaceId": "<workspaceId>",
"blockId": "<blockId>",
"domainId": "<domainId>",
"path": "<path>"
},
"name": "deploy_endpoint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Endpoint path, e.g. "orders". A path may be a FILE NAME ("index.html", "sitemap.xml"), and "/" deploys at the domain ROOT — https://api.qu4zr.io/{slug}/ — which is where a site's home page belongs. Avoid a first folder that looks like a version label ("v1", "latest", "dev"…): the gateway reads that segment as a version, not a folder. | |
| notes | No | ||
| blockId | Yes | ||
| confirm | No | Must be true to deploy. Omit/false returns a preview only. | |
| domainId | Yes | Target API domain id — call list_domains to find it (owned by the workspace owner). | |
| isAnonymous | No | ||
| workspaceId | Yes | ||
| allowedVerbs | No | ||
| detailedOutput | No |