# Headless · Management API

> Management API reference for headless: POST /headless/access-requests.

> Markdown version of https://kanorio.com/en/developers/management-api/headless. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp

Base URL: `https://app.kanorio.com/api/v1` · [Errors](https://kanorio.com/en/developers/basics/errors) · [Pagination](https://kanorio.com/en/developers/basics/pagination)

### Request access

`POST /headless/access-requests`

- Stability: beta
- Permission: `console:view`
- Rate limit: publish (30/hour per token)
- MCP tool: `headless_request_access`

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**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `intendedUse` | "brand" \| "landing" \| "blog" \| "media" \| "portfolio" \| "courses" \| "membership" \| "commerce" \| "newsletter" \| "events" \| "booking" \| "docs" \| "app"[] | yes | 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"[] | yes | 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" | yes | How we may contact the user. Ask the user. |
| `contactHandle` | string | yes | Email address, phone number (E.164 for whatsapp) or handle on that channel, exactly as the user gave it. |
| `confirmedByUser` | true | yes | Set to true only after the user has answered every field above and agreed to submit. |

**Response** (201)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `requestId` | string | yes | — |
| `created` | boolean | yes | false when an application was already waiting. |
| `status` | "PENDING" | yes | — |
| `reviewSlaWorkingDays` | integer | yes | — |
| `guidance` | string | yes | — |

**Errors**

| Code | Status | When |
| --- | --- | --- |
| `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 | — |

```bash
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}'
```

```json
{
  "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."
}
```
