{
  "page": "docs",
  "title": "Docs",
  "lead": "Arettic gives an agent one key for sales and research data tools. It recommends the tool that works for a task, runs it, checks the result against a published rule and charges only if it passes. Every page here is also Markdown (add .md) and JSON (add .json).",
  "steps": [
    {
      "name": "Recommend",
      "text": "POST /v1/recommend ranks the tools for a task by score, then price. Free."
    },
    {
      "name": "Execute",
      "text": "POST /v1/execute runs one tool with one key. Credits are held before the call."
    },
    {
      "name": "Check",
      "text": "Each item runs the published pass rule for its task type. The rule's version is on the receipt."
    },
    {
      "name": "Settle",
      "text": "Pass: credits captured, full result returned. Fail: hold released, reason returned, data withheld."
    }
  ],
  "sections": [
    {
      "section": "Getting started",
      "pages": [
        {
          "slug": "quickstart",
          "title": "Quickstart",
          "description": "From a key to a receipt: recommend a tool, execute it, read the result, and see what you were charged.",
          "html": "https://arettic.com/docs/quickstart",
          "markdown": "https://arettic.com/docs/quickstart.md",
          "json": "https://arettic.com/docs/quickstart.json"
        },
        {
          "slug": "authentication",
          "title": "Authentication and keys",
          "description": "Agent keys, org keys and sessions: what each can do, how to send them, and how to rotate or revoke them.",
          "html": "https://arettic.com/docs/authentication",
          "markdown": "https://arettic.com/docs/authentication.md",
          "json": "https://arettic.com/docs/authentication.json"
        },
        {
          "slug": "test-mode",
          "title": "Test mode",
          "description": "Mock providers with fixed answers: build the pass and the fail path without spending a credit.",
          "html": "https://arettic.com/docs/test-mode",
          "markdown": "https://arettic.com/docs/test-mode.md",
          "json": "https://arettic.com/docs/test-mode.json"
        },
        {
          "slug": "mcp",
          "title": "MCP server",
          "description": "Connect Claude, Cursor or any MCP client: the Streamable HTTP endpoint, the stdio bridge, and the nine tools.",
          "html": "https://arettic.com/docs/mcp",
          "markdown": "https://arettic.com/docs/mcp.md",
          "json": "https://arettic.com/docs/mcp.json"
        },
        {
          "slug": "sdks",
          "title": "SDKs",
          "description": "The TypeScript and Python clients: install, the agent client, the org client, errors and retries.",
          "html": "https://arettic.com/docs/sdks",
          "markdown": "https://arettic.com/docs/sdks.md",
          "json": "https://arettic.com/docs/sdks.json"
        }
      ]
    },
    {
      "section": "Buying results",
      "pages": [
        {
          "slug": "recommend",
          "title": "Recommend",
          "description": "Ask which tool works for a task and get them ranked by score, then price.",
          "html": "https://arettic.com/docs/recommend",
          "markdown": "https://arettic.com/docs/recommend.md",
          "json": "https://arettic.com/docs/recommend.json"
        },
        {
          "slug": "execute",
          "title": "Execute",
          "description": "Run a tool on one input or a batch, and pay only for items that pass the published check.",
          "html": "https://arettic.com/docs/execute",
          "markdown": "https://arettic.com/docs/execute.md",
          "json": "https://arettic.com/docs/execute.json"
        },
        {
          "slug": "jobs",
          "title": "Batches and jobs",
          "description": "More than 25 inputs run as a job: the hold, the states, polling, and the completion webhook.",
          "html": "https://arettic.com/docs/jobs",
          "markdown": "https://arettic.com/docs/jobs.md",
          "json": "https://arettic.com/docs/jobs.json"
        },
        {
          "slug": "receipts",
          "title": "Receipts",
          "description": "Every purchase ends in an immutable receipt: what was asked, what ran, what it cost, what was refunded.",
          "html": "https://arettic.com/docs/receipts",
          "markdown": "https://arettic.com/docs/receipts.md",
          "json": "https://arettic.com/docs/receipts.json"
        },
        {
          "slug": "disputes",
          "title": "Disputes",
          "description": "Think a charged result was wrong? Dispute it within 7 days; we decide within 48 hours against the stored result.",
          "html": "https://arettic.com/docs/disputes",
          "markdown": "https://arettic.com/docs/disputes.md",
          "json": "https://arettic.com/docs/disputes.json"
        },
        {
          "slug": "budgets-and-approvals",
          "title": "Budgets and approvals",
          "description": "Per-agent budgets and approval thresholds, enforced on our side: what happens when a purchase needs a person.",
          "html": "https://arettic.com/docs/budgets-and-approvals",
          "markdown": "https://arettic.com/docs/budgets-and-approvals.md",
          "json": "https://arettic.com/docs/budgets-and-approvals.json"
        },
        {
          "slug": "pass-rules",
          "title": "Pass rules",
          "description": "Six task types, one published check each: what passes, what fails, and what is refunded.",
          "html": "https://arettic.com/docs/pass-rules",
          "markdown": "https://arettic.com/docs/pass-rules.md",
          "json": "https://arettic.com/docs/pass-rules.json"
        },
        {
          "slug": "scores",
          "title": "How scores work",
          "description": "The score formula, its six inputs, where each comes from, when scores change and how to cite one.",
          "html": "https://arettic.com/docs/scores",
          "markdown": "https://arettic.com/docs/scores.md",
          "json": "https://arettic.com/docs/scores.json"
        }
      ]
    },
    {
      "section": "Running an org",
      "pages": [
        {
          "slug": "org-api",
          "title": "Org API: everything the dashboard does",
          "description": "Org keys drive every dashboard action through the API: agents, budgets, approvals, receipts, billing, webhooks and team.",
          "html": "https://arettic.com/docs/org-api",
          "markdown": "https://arettic.com/docs/org-api.md",
          "json": "https://arettic.com/docs/org-api.json"
        },
        {
          "slug": "webhooks",
          "title": "Webhooks and notifications",
          "description": "One event list, delivered as signed webhooks on every plan and emailed to owners where a person should know.",
          "html": "https://arettic.com/docs/webhooks",
          "markdown": "https://arettic.com/docs/webhooks.md",
          "json": "https://arettic.com/docs/webhooks.json"
        },
        {
          "slug": "credits",
          "title": "Credits, top-ups and plans",
          "description": "The credit unit, balances, top-ups in US dollars, auto-reload, expiry, trial credits and plans.",
          "html": "https://arettic.com/docs/credits",
          "markdown": "https://arettic.com/docs/credits.md",
          "json": "https://arettic.com/docs/credits.json"
        },
        {
          "slug": "data-handling",
          "title": "Data handling and retention",
          "description": "What we store, for how long, encrypted with what, and how to have it deleted.",
          "html": "https://arettic.com/docs/data-handling",
          "markdown": "https://arettic.com/docs/data-handling.md",
          "json": "https://arettic.com/docs/data-handling.json"
        }
      ]
    },
    {
      "section": "Reference",
      "pages": [
        {
          "slug": "public-data",
          "title": "Public data and formats",
          "description": "The no-key endpoints, the Markdown and JSON copy of every page, the discovery files, and the licence.",
          "html": "https://arettic.com/docs/public-data",
          "markdown": "https://arettic.com/docs/public-data.md",
          "json": "https://arettic.com/docs/public-data.json"
        },
        {
          "slug": "rate-limits",
          "title": "Rate limits and quotas",
          "description": "Every limit, what it is keyed on, the headers that report it, and how to back off.",
          "html": "https://arettic.com/docs/rate-limits",
          "markdown": "https://arettic.com/docs/rate-limits.md",
          "json": "https://arettic.com/docs/rate-limits.json"
        }
      ]
    }
  ],
  "reference": {
    "error_codes": "https://arettic.com/docs/errors.json",
    "schemas": "https://arettic.com/schemas.json",
    "changelog": "https://arettic.com/changelog.json",
    "openapi": "https://arettic.com/openapi.json",
    "mcp_card": "https://arettic.com/.well-known/mcp.json",
    "llms": "https://arettic.com/llms.txt"
  },
  "task_types": [
    "find_email",
    "verify_email",
    "enrich_company",
    "enrich_person",
    "web_search",
    "extract_url"
  ],
  "api": "https://api.arettic.com"
}