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

# Create System One typed decision

> Run Laya/System One typed decisions. Current model: `convaiinnovations/laya`. This is not an OpenAI chat-completions endpoint; use it for `choice`, `score`, and `noul` questions. Authenticate with `X-API-Key` (prepaid credits) or pay per request with x402 after a `402` challenge. For end-to-end private Laya, first reserve a node with `POST /v1/systemone/reserve`, encrypt locally to the returned node key, then submit the sealed payload here.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/systemone
openapi: 3.1.0
info:
  title: x402 Singularity Layer API
  description: >-
    OpenAPI-backed reference for marketplace discovery, payment routes,
    webhooks, wallet-first auth, agent endpoints, and ERC-8004 flows.
  version: 1.0.0
servers:
  - url: https://api.x402layer.cc
security: []
tags:
  - name: Marketplace
    description: Public discovery and listing lookup
  - name: Public Endpoints
    description: Public endpoint metadata and hosted checkout context
  - name: Public Payment Links
    description: Hosted public payment-link lookup
  - name: Payments
    description: Hosted x402 payment challenge routes
  - name: Receipts
    description: Signed receipt lookup and verification helpers
  - name: Ratings
    description: Public listing ratings and authenticated rating actions
  - name: Webhooks
    description: Seller webhook management API
  - name: Agent Auth
    description: Wallet-first challenge and verification routes
  - name: Agent Endpoints
    description: Create, read, top up, and delete agent endpoints
  - name: ERC-8004
    description: Agent registry and registration lifecycle routes
  - name: Marketplace Agents
    description: Public ERC-8004 marketplace discovery routes
  - name: Compute Catalog
    description: Compute plans, regions, and OS catalog
  - name: Compute Instances
    description: Provision, inspect, extend, and destroy compute instances
  - name: Compute API Keys
    description: API keys for compute agent access
  - name: Fundraiser Campaigns
    description: List, view, create, and edit fundraiser campaigns
  - name: Fundraiser Contributions
    description: Record and list campaign contributions
  - name: Fundraiser Comments
    description: Campaign comment threads
  - name: Fundraiser Media
    description: Campaign image uploads and OG images
  - name: Enterprise
    description: >-
      Enterprise partner configuration, endpoint listing, revenue stats, and
      transaction ledger
  - name: Staking
    description: Agentic $SGL staking
  - name: SGL Grid
    description: >-
      Decentralized, confidential, OpenAI-compatible inference served by
      attested TEE nodes.
  - name: Compute Credits
    description: Prepaid USDC credit balance shared across Machines and Grid.
  - name: Agent Pods
    description: >-
      Deploy and manage hosted agents (Agent Pods), plus the pod's
      OpenAI-compatible adapter for external clients.
  - name: Agent Pods API
    description: >-
      The programmatic `/pods/v1` surface: create, drive and destroy Agent Pods
      with a single `X-API-Key`. Distinct from the Agent Pods dashboard routes,
      which expect a wallet signature or a browser session.
paths:
  /v1/systemone:
    servers:
      - url: https://grid.x402compute.cc
    post:
      tags:
        - SGL Grid
      summary: Create System One typed decision
      description: >-
        Run Laya/System One typed decisions. Current model:
        `convaiinnovations/laya`. This is not an OpenAI chat-completions
        endpoint; use it for `choice`, `score`, and `noul` questions.
        Authenticate with `X-API-Key` (prepaid credits) or pay per request with
        x402 after a `402` challenge. For end-to-end private Laya, first reserve
        a node with `POST /v1/systemone/reserve`, encrypt locally to the
        returned node key, then submit the sealed payload here.
      parameters:
        - name: X-API-Key
          in: header
          required: false
          schema:
            type: string
            example: x402c_...
          description: >-
            Compute/Grid API key (billed to prepaid credits). Omit to pay per
            request via x402 `X-Payment`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - state
                - questions
              properties:
                model:
                  type: string
                  example: convaiinnovations/laya
                state:
                  description: JSON-serializable state for the decision. Max 64 KiB.
                  oneOf:
                    - type: object
                    - type: string
                    - type: array
                questions:
                  type: object
                  description: Object keyed by question id. Max 32 questions.
                  additionalProperties:
                    type: object
                    required:
                      - type
                      - instructions
                    properties:
                      type:
                        type: string
                        enum:
                          - choice
                          - score
                          - noul
                      instructions:
                        type: string
                      criteria:
                        description: >-
                          `choice` uses an object with at least two options.
                          `score` uses a non-empty array of criteria strings.
                        oneOf:
                          - type: object
                            additionalProperties:
                              type: string
                          - type: array
                            items:
                              type: string
                  example:
                    route:
                      type: choice
                      instructions: Pick the best team.
                      criteria:
                        billing: Billing or refund issue
                        support: Technical support issue
      responses:
        '200':
          description: Typed System One result
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    example: systemone.result
                  model:
                    type: string
                    example: convaiinnovations/laya
                  answers:
                    type: object
                    additionalProperties:
                      type: object
                  usage:
                    type: object
                    properties:
                      input_tokens:
                        type: integer
                      output_tokens:
                        type: integer
                      cost_usd:
                        type: number
        '400':
          description: Invalid System One request
        '401':
          description: Invalid or revoked API key
        '402':
          description: >-
            Payment required — resend with `X-Payment`, or top up credits in
            Settings → Credits

````