Kanorio

API reference

Headless

Management API: POST /headless/access-requests

Base URL https://app.kanorio.com/api/v1ErrorsPagination

Request access

POST/headless/access-requests
betaconsole:viewpublish (30/hour per token)

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"[]required

    What 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"[]required

    Tools 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"required

    How we may contact the user. Ask the user.

  • contactHandlestringrequired

    Email address, phone number (E.164 for whatsapp) or handle on that channel, exactly as the user gave it.

  • confirmedByUsertruerequired

    Set to true only after the user has answered every field above and agreed to submit.

Response 201

  • requestIdstringrequired
  • createdbooleanrequired

    false when an application was already waiting.

  • status"PENDING"required
  • reviewSlaWorkingDaysintegerrequired
  • guidancestringrequired

Errors

  • VALIDATION 400
  • HEADLESS_PENDING_EXISTS 409
  • HEADLESS_REAPPLY_COOLDOWN 409 · details.reapplyAfter
  • HEADLESS_ACCESS_ALREADY_GRANTED 409 · already invited, or the beta is over: create the site directly
  • HEADLESS_ACCESS_REVOKED 403

MCP tool headless_request_access

curlTypeScript
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}'
Response
{
  "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."
}