{
  "name": "Kolja Pitz — API Directory",
  "description": "Machine-readable endpoints for AI agents and integrations.",
  "version": "2.0",
  "schema_version": "2025-03",
  "last_updated": "2026-09-06",
  "baseUrl": "https://koljapitz.de",
  "endpoints": {
    "services": {
      "url": "/api/services.json",
      "description": "Schema.org OfferCatalog of all services, bilingual (DE/EN)",
      "format": "application/ld+json"
    },
    "work": {
      "url": "/api/work.json",
      "description": "Schema.org ItemList of all portfolio case studies",
      "format": "application/ld+json"
    },
    "capabilities": {
      "url": "/api/capabilities.json",
      "description": "Capability graph as Schema.org ItemList/DefinedTerm with case and technology mappings",
      "format": "application/ld+json"
    },
    "problemTypes": {
      "url": "/api/problem-types.json",
      "description": "Problem types mapped to capabilities and relevant cases",
      "format": "application/ld+json"
    },
    "thinking": {
      "url": "/api/thinking.json",
      "description": "Schema.org ItemList of articles, essays, and field notes",
      "format": "application/ld+json"
    },
    "availability": {
      "url": "/api/availability.json",
      "description": "Build-time Cal.com slot snapshot (next 14 days)",
      "format": "application/ld+json"
    },
    "search": {
      "url": "/api/search?q={query}",
      "description": "Full-text search across work, services, capabilities, and problem types",
      "format": "application/json",
      "parameters": {
        "q": "required",
        "type": "optional (work|services|capabilities|problem-types)",
        "limit": "optional (max 50)"
      }
    },
    "workflows/booking": {
      "url": "/api/workflows/booking.json",
      "description": "Server-side booking orchestration — fetches event types, finds slots, returns curated options in one request",
      "format": "application/json",
      "methods": [
        "GET",
        "POST"
      ]
    },
    "workflows/discovery": {
      "url": "/api/workflows/discovery.json",
      "description": "Server-side discovery orchestration — profile, capabilities, work, services in one request",
      "format": "application/json",
      "methods": [
        "GET"
      ]
    },
    "negotiate": {
      "url": "/api/negotiate",
      "description": "Agent-to-agent capability negotiation — POST a query to check if this agent can handle your request",
      "format": "application/json",
      "methods": [
        "GET",
        "POST"
      ]
    },
    "openapi": {
      "url": "/api/openapi.json",
      "description": "OpenAPI 3.1 specification for all API endpoints",
      "format": "application/json"
    }
  },
  "discovery": {
    "markdown_summary": "/index.md",
    "markdown_full": "/content.md",
    "markdown_cases": "/cases.md",
    "markdown_capabilities": "/capabilities.md",
    "sitemap": "/sitemap-index.xml",
    "robots": "/robots.txt",
    "agent_card": "/.well-known/agent.json",
    "agent_card_legacy": "/.well-known/agent-card.json",
    "agent_docs": "/agent"
  },
  "contact": {
    "email": "kp@plateaucandy.de",
    "booking": "https://cal.com/koljapitz",
    "website": "https://koljapitz.de/contact"
  },
  "rateLimits": {
    "limit": 60,
    "window": "60s",
    "headers": [
      "X-RateLimit-Limit",
      "X-RateLimit-Remaining",
      "X-RateLimit-Reset",
      "Retry-After"
    ],
    "exceeded": "HTTP 429 Too Many Requests with Retry-After header"
  },
  "structuredData": {
    "note": "Every page includes JSON-LD with Person, Organization, ProfessionalService, and CreativeWork schemas. Case study pages include DefinedTerm (capability areas) and HowToTool references."
  }
}