> ## Documentation Index
> Fetch the complete documentation index at: https://arcpay-somnia.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Request ArcPay Somnia beta access

> Stores a beta request in the dedicated beta table when available, or falls back to the audit records table until the migration is applied.



## OpenAPI

````yaml /apps/frontend/public/openapi.json post /api/beta
openapi: 3.1.0
info:
  title: ArcPay Somnia Developer API
  version: 0.1.2
  summary: >-
    Public developer surface for ArcPay's Somnia x402, workspace evidence, and
    agent integration flows.
  description: >-
    ArcPay Somnia exposes a wallet-first app, a live x402 payment server, an MCP
    server for local agent hosts, and OpenAPI-compatible endpoint docs for
    developers building on Somnia Testnet.
servers:
  - url: https://x402.20.208.46.195.nip.io
    description: Live ArcPay Somnia x402 server
  - url: https://arcpay-somnia.vercel.app
    description: ArcPay Somnia frontend and workspace API
security: []
tags:
  - name: x402
    description: HTTP 402 payment-gated agent work on Somnia.
  - name: Workspace
    description: Workspace authentication and evidence mirror endpoints.
  - name: Beta
    description: Public beta access requests for Somnia builders and operators.
  - name: Discovery
    description: Machine-readable docs and integration discovery.
  - name: Developer Tools
    description: HTTP wrapper around safe ArcPay MCP-style tools.
  - name: MCP
    description: Hosted MCP-style JSON-RPC bridge for agent clients.
  - name: Developer Keys
    description: Workspace-scoped bearer keys for hosted MCP access.
  - name: Admin
    description: Operator-only beta queue management endpoints.
  - name: Status
    description: Runtime health checks for ArcPay Somnia production surfaces.
paths:
  /api/beta:
    post:
      tags:
        - Beta
      summary: Request ArcPay Somnia beta access
      description: >-
        Stores a beta request in the dedicated beta table when available, or
        falls back to the audit records table until the migration is applied.
      operationId: requestBetaAccess
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BetaSignupRequest'
      responses:
        '200':
          description: Beta request stored in the beta queue.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BetaSignupResponse'
        '202':
          description: Beta request stored in the records fallback table.
components:
  schemas:
    BetaSignupRequest:
      type: object
      required:
        - name
        - email
        - role
        - useCase
      properties:
        name:
          type: string
        email:
          type: string
          format: email
        telegram:
          type: string
        walletAddress:
          type: string
        role:
          type: string
        useCase:
          type: string
        agentUrl:
          type: string
    BetaSignupResponse:
      type: object
      properties:
        ok:
          type: boolean
        mode:
          type: string
          enum:
            - beta_table
            - records_fallback
        message:
          type: string
        telegramUrl:
          type: string

````