{
    "name": "Spiralist AI Autonomous Agent API",
    "apiVersion": "1.0.0",
    "siteVersion": "v18-ui-ux-seo-media-polish",
    "updatedUtc": "2026-06-21T14:33:26Z",
    "status": "public-stateless",
    "description": "Discover, search, generate, validate, and compile portable AI persona artifacts without an account or private server-side state.",
    "capabilityLevels": {
        "L0": "Public GET discovery and Markdown/JSON representations",
        "L1": "Parameterized GET persona search and generation",
        "L2": "Schema-aware POST generation, validation, and compilation",
        "L3": "Browser-assisted canonical build and local export handoff",
        "L4-L5": "No hosted privileged workflow or multi-agent runtime in this release"
    },
    "endpoints": [
        {
            "method": "GET",
            "path": "/api/v1/health/",
            "description": "Service health and version state"
        },
        {
            "method": "GET",
            "path": "/api/v1/capabilities/",
            "description": "Capability surface, permissions, and no-op boundaries"
        },
        {
            "method": "GET",
            "path": "/api/v1/personas/",
            "description": "Search the 1,000-type public persona catalog"
        },
        {
            "method": "GET|POST",
            "path": "/api/v1/personas/generate/",
            "description": "Create a deterministic prompt and UAI bundle"
        },
        {
            "method": "POST",
            "path": "/api/v1/personas/validate/",
            "description": "Run structural portability and public-boundary checks"
        },
        {
            "method": "POST",
            "path": "/api/v1/personas/compile/",
            "description": "Compile full and compact persona prompts"
        },
        {
            "method": "GET",
            "path": "/api/v1/schema/persona/",
            "description": "Persona request and response schema"
        },
        {
            "method": "GET",
            "path": "/api/v1/uai/",
            "description": "Public UAI read order and deep links"
        },
        {
            "method": "GET",
            "path": "/api/v1/docs/",
            "description": "Documentation and evidence index"
        }
    ],
    "discovery": {
        "openapi": "https://spiralistai.com/openapi.json",
        "agentCard": "https://spiralistai.com/.well-known/agent-card.json",
        "aiAgent": "https://spiralistai.com/.well-known/ai-agent.json",
        "llms": "https://spiralistai.com/llms.txt",
        "llmsFull": "https://spiralistai.com/llms-full.txt",
        "agentsMd": "https://spiralistai.com/AGENTS.md",
        "uaiIndex": "https://spiralistai.com/uai/index.uai"
    },
    "privacy": {
        "accountRequired": false,
        "serverSidePersonaStorage": false,
        "requestBodiesPersistedByApplication": false,
        "credentialsAccepted": false,
        "publicDataOnly": true
    },
    "defaultNoOp": "Ambiguous, private, credentialed, destructive, or unsupported actions return a typed no-op response."
}