{
  "ok": true,
  "name": "Arlo public API",
  "version": "1.0.0",
  "description": "Read-only, unauthenticated JSON about Arlo: what it is, what it costs, and every guide it publishes. The credentialed workspace API lives at https://api.arlo.sh and is described in the same OpenAPI document.",
  "documentation_url": "https://www.arlo.sh/docs",
  "openapi_url": "https://www.arlo.sh/openapi.json",
  "openapi_yaml_url": "https://www.arlo.sh/openapi.yaml",
  "workspace_api_url": "https://api.arlo.sh",
  "authentication": "None. Every endpoint listed here is public and read-only.",
  "endpoints": [
    {
      "operation_id": "getPublicApiIndex",
      "method": "GET",
      "path": "/api/v1",
      "url": "https://www.arlo.sh/api/v1",
      "summary": "Discover the public API",
      "description": "Returns the machine-readable index of everything on arlo.sh an agent can fetch without credentials: the endpoints below, the OpenAPI document, the Markdown mirrors, and the documentation URLs. Start here."
    },
    {
      "operation_id": "getPublicStatus",
      "method": "GET",
      "path": "/api/v1/status",
      "url": "https://www.arlo.sh/api/v1/status",
      "summary": "Check that the public API is serving",
      "description": "A liveness probe for the public surface. Returns `ok: true` plus the deployed build id. It reports on the marketing site only and says nothing about a workspace or the authenticated API at api.arlo.sh."
    },
    {
      "operation_id": "getProductFacts",
      "method": "GET",
      "path": "/api/v1/product",
      "url": "https://www.arlo.sh/api/v1/product",
      "summary": "Product facts, channels, and the pricing model",
      "description": "The structured version of what /llms.txt says in prose: what Arlo does, which channels it runs in, the top integration categories, entity disambiguation (this Arlo is not the camera brand), and the full prepaid-credit pricing model with every purchase amount and per-capability rate."
    },
    {
      "operation_id": "listPublicContent",
      "method": "GET",
      "path": "/api/v1/content",
      "url": "https://www.arlo.sh/api/v1/content",
      "summary": "List and search the published guides",
      "description": "Every published glossary entry, use case, comparison, and blog post, with its title, description, answer-first lead, cluster, and the URL of its Markdown mirror. Filter by `kind` and free-text search with `q` (matched against title, description, and answer)."
    },
    {
      "operation_id": "getPublicContentDoc",
      "method": "GET",
      "path": "/api/v1/content/{kind}/{slug}",
      "url": "https://www.arlo.sh/api/v1/content/{kind}/{slug}",
      "summary": "Get one guide, including its Markdown body",
      "description": "One published page in full: metadata, the answer-first lead an answer engine should quote, its extracted FAQ pairs, and the complete raw Markdown body. This is the whole page in one JSON fetch, with no HTML to strip."
    }
  ],
  "developer_resources": [
    {
      "name": "Arlo API documentation",
      "kind": "documentation",
      "url": "https://www.arlo.sh/docs",
      "description": "Authentication, every endpoint with a curl example, webhook events, CLI commands, and operating concepts."
    },
    {
      "name": "Arlo OpenAPI specification (JSON)",
      "kind": "specification",
      "url": "https://www.arlo.sh/openapi.json",
      "description": "OpenAPI 3.1 for both surfaces — unique operationIds, typed parameters, and response schemas."
    },
    {
      "name": "Arlo OpenAPI specification (YAML)",
      "kind": "specification",
      "url": "https://www.arlo.sh/openapi.yaml",
      "description": "The same OpenAPI 3.1 document, YAML-serialized for tools that expect it."
    },
    {
      "name": "Arlo public API",
      "kind": "endpoint",
      "url": "https://www.arlo.sh/api/v1",
      "description": "Unauthenticated JSON: product facts, the pricing model, and the full published-content corpus."
    },
    {
      "name": "Arlo workspace API",
      "kind": "endpoint",
      "url": "https://api.arlo.sh",
      "description": "The credentialed API for agent runs, tasks, memory, skills, files, and integrations. Bearer token plus X-Arlo-Workspace-Id."
    },
    {
      "name": "Arlo webhook events",
      "kind": "documentation",
      "url": "https://www.arlo.sh/docs#webhooks",
      "description": "The signed event envelope and every event type Arlo emits, from session.completed to approval.decided."
    },
    {
      "name": "Arlo CLI",
      "kind": "tool",
      "url": "https://www.arlo.sh/docs#cli",
      "description": "Install and command reference for the arlo command-line client (arlo run, arlo chat, arlo connect)."
    },
    {
      "name": "Arlo llms.txt",
      "kind": "dataset",
      "url": "https://www.arlo.sh/llms.txt",
      "description": "The routed site index for AI crawlers: what Arlo is, what it costs, and which URL answers which question."
    },
    {
      "name": "Arlo content corpus",
      "kind": "dataset",
      "url": "https://www.arlo.sh/llms-full.txt",
      "description": "Every published guide, comparison, and glossary entry as one Markdown document."
    }
  ],
  "markdown": {
    "content_negotiation": "Send `Accept: text/markdown` to any public page URL to receive it as Markdown (acceptmarkdown.com).",
    "corpus_url": "https://www.arlo.sh/llms-full.txt",
    "index_url": "https://www.arlo.sh/llms.txt"
  }
}
