API reference
Headless
Management API: POST /headless/access-requests
Submit the account's application to the custom-frontend (headless) beta on the user's behalf. Nothing is created: the team replies with an invitation or a reason. Ask the user each question (what they want to build, which tools or frameworks, contact channel and handle) and wait for their answers; never infer or auto-fill a field. Call account.context first. Idempotent: an application that is already waiting is returned with created=false. Errors: VALIDATION, HEADLESS_PENDING_EXISTS, HEADLESS_REAPPLY_COOLDOWN (details.reapplyAfter), HEADLESS_ACCESS_ALREADY_GRANTED (already invited, or the beta is over: create the site directly), HEADLESS_ACCESS_REVOKED.
Request body
intendedUse"brand" | "landing" | "blog" | "media" | "portfolio" | "courses" | "membership" | "commerce" | "newsletter" | "events" | "booking" | "docs" | "app"[]requiredWhat the user wants to build. Ask the user; do not infer from the project.
intendedStack"cursor" | "claude-code" | "codex" | "copilot" | "antigravity" | "devin" | "lovable" | "v0" | "bolt" | "replit" | "nextjs" | "astro" | "nuxt" | "sveltekit" | "react-router" | "tanstack-start" | "react-vite" | "vue" | "angular" | "hugo" | "expo" | "flutter" | "ios" | "android"[]requiredTools or frameworks the user plans to use. Ask the user; do not infer from the editor you run in.
contactChannel"email" | "whatsapp" | "line" | "telegram" | "wechat" | "kakaotalk"requiredHow we may contact the user. Ask the user.
contactHandlestringrequiredEmail address, phone number (E.164 for whatsapp) or handle on that channel, exactly as the user gave it.
confirmedByUsertruerequiredSet to true only after the user has answered every field above and agreed to submit.
Response 201
requestIdstringrequiredcreatedbooleanrequiredfalse when an application was already waiting.
status"PENDING"requiredreviewSlaWorkingDaysintegerrequiredguidancestringrequired
Errors
VALIDATION400HEADLESS_PENDING_EXISTS409HEADLESS_REAPPLY_COOLDOWN409 · details.reapplyAfterHEADLESS_ACCESS_ALREADY_GRANTED409 · already invited, or the beta is over: create the site directlyHEADLESS_ACCESS_REVOKED403
MCP tool headless_request_access
curl -X POST "https://app.kanorio.com/api/v1/headless/access-requests" \
-H "Authorization: Bearer $KANORIO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intendedUse":["blog","courses"],"intendedStack":["nextjs","cursor"],"contactChannel":"email","contactHandle":"owner@example.com","confirmedByUser":true}'{
"requestId": "har_example01",
"created": true,
"status": "PENDING",
"reviewSlaWorkingDays": 3,
"guidance": "The application is waiting for an invitation; we reply within about 3 working days. Explain this and stop."
}