Skip to content
Quirello developer docs
Esc
navigateopen⌘Jpreview
On this page

Supported Quirello surface

Exact operator operations, public routes, bindings, and error meanings.

The table below renders from QUIRELLO_OPERATOR_OPERATIONS. The registry owns operation names, descriptions, input and result schemas, and declared error codes.

OperationDescriptionDeclared errors
quirello.redirect.getGet one redirect rule by its exact source pathinvalid-input, dependency-unavailable, internal-error, not-found
quirello.redirect.listList redirect rulesinvalid-input, dependency-unavailable, internal-error
quirello.redirect.upsertCreate or update an exact-match redirect ruleinvalid-input, dependency-unavailable, internal-error
quirello.redirect.deleteDelete a redirect rule by its source pathinvalid-input, dependency-unavailable, internal-error
quirello.redirect.sync-indexRebuild the optional redirect lookup indexinvalid-input, dependency-unavailable, internal-error
quirello.form.getGet one configured form definitioninvalid-input, dependency-unavailable, internal-error, not-found
quirello.form.upsertCreate or update a form definitioninvalid-input, dependency-unavailable, internal-error
quirello.form-submission.listList stored submissions for a form, newest firstinvalid-input, dependency-unavailable, internal-error, not-found
quirello.media-asset.getGet one media asset by its stable idinvalid-input, dependency-unavailable, internal-error, not-found
quirello.media-asset.listList media assets, optionally filtered by usage or origininvalid-input, dependency-unavailable, internal-error
quirello.media-asset.update-metadataUpdate metadata on an existing media assetinvalid-input, dependency-unavailable, internal-error, not-found
quirello.media-upload.create-intentCreate an upload intent and signed byte-transfer URLinvalid-input, dependency-unavailable, internal-error, conflict
quirello.media-upload.finalizeFinalize a previously transferred media assetinvalid-input, dependency-unavailable, internal-error, not-found

Inspect the canonical operation registry for exact input and result schemas. All Operator errors use one of these codes: invalid-input, not-found, conflict, dependency-unavailable, internal-error.

public HTTP routes

Method and route Purpose Mutation authority
GET /q/forms/:slug Read an active normalized form definition. Read only.
POST /q/forms/:slug/submit Validate and persist a public form submission. Narrow public intake.
GET /q/media/assets/:id Read stored media bytes. Read only.
Signed PUT /q/media/upload/:id?... Transfer bytes for one upload intent. Signed byte transfer only.
MCP transport at /q/mcp Expose the Operator Contract. The only operator mutation surface.

There are no direct HTTP routes for redirect, form-definition, or media-metadata mutations.

Cloudflare host bindings

Binding Consumer Behavior when absent
QUIRELLO_DB Forms, submissions, media records, and canonical redirects. Local hosts can use seeded memory state; remote operations that need D1 fail.
QUIRELLO_MEDIA Media byte storage. Local hosts can use memory state; remote media operations fail.
QUIRELLO_REDIRECTS_KV Optional derived redirect lookup index. Redirect operations use the canonical store without that index.
QUIRELLO_OPERATOR_TOKEN Non-local MCP authentication. The MCP endpoint returns unavailable.
QUIRELLO_UPLOAD_SIGNING_SECRET Signed Upload URL creation and verification. Signed transfer cannot be authorized remotely.
QUIRELLO_FORM_RATE_LIMITER Optional public form intake limit. Intake proceeds without this optional limit.

The Website Host Adapter supplies bindings, route mounting, redirect lookup scope, and site presentation. For a detailed runnable use of the registry, read the redirect source tutorial and its test.

Was this page helpful?