---
title: "lobo — Developer Portal & API Reference (lobo.sh)"
description: "Machine-readable interfaces, REST API reference, OpenAPI 3.1.0 specifications, quickstart curl commands, and LLM agent guidelines for lobo.sh."
canonical: "https://lobo.sh/developers"
---

# lobo.sh Developer Portal & API Reference

> lobo.sh provides first-class programmatic interfaces designed for software engineers, automated tool execution, and autonomous AI agents.

## lobo.sh Core Specifications
- **OpenAPI 3.1.0 Specification (JSON):** https://lobo.sh/openapi.json
- **OpenAPI Specification (YAML):** https://lobo.sh/api/openapi.yaml
- **LLM Context Manifest:** https://lobo.sh/llms.txt
- **Complete Knowledge Graph:** https://lobo.sh/llms-full.txt
- **Agent Instructions:** https://lobo.sh/agent-instructions.md

## lobo.sh API Quickstart (curl)
```bash
# 1. Health check & version discovery
curl -s -i https://lobo.sh/api/v1/health

# 2. Author profile, background & verified links
curl -s https://lobo.sh/api/v1/profile

# 3. List published technical essays
curl -s https://lobo.sh/api/v1/essays

# 4. Fetch essay content and metadata by slug
curl -s https://lobo.sh/api/v1/essays/architecture-decisions

# 5. Search site catalog
curl -s https://lobo.sh/api/v1/search

# 6. Content negotiation (request raw markdown)
curl -s -H "Accept: text/markdown" https://lobo.sh/
```

## lobo.sh API Authentication & Rate Limit Policy
- **Public Read-Only:** All endpoints are public; no API key or token is required.
- **CORS:** Enabled globally (`Access-Control-Allow-Origin: *`) for direct agent tool calling and browser sandboxes.
- **Fair-Use Limit:** 60 requests/minute per client.
- **RFC Rate Limit Headers:** Responses include real-time throttling metadata:
  - `RateLimit-Limit: 60`
  - `RateLimit-Remaining: 59`
  - `RateLimit-Reset: 60`
  - `RateLimit-Policy: 60;w=60`
- **HTTP 429 Recovery:** Exceeding quota returns HTTP 429 with `Retry-After: <seconds>`.
- **Structured Error Format:** JSON errors (`code`, `message`, `resolution_hint`) on 4xx/5xx status codes.

## lobo.sh API Versioning & Deprecation Policy
- **Path-Based Versioning:** Active version is `v1` (`/api/v1/...`).
- **Version Headers:** Emits `API-Version: 1.0.0` and `X-API-Version: 1.0.0` headers.
- **Deprecation Signaling:** Deprecated endpoints emit RFC 9594 `Deprecation: @<timestamp>` and RFC 8594 `Sunset: <HTTP-date>` response headers.
- **Sunset Window:** Minimum guaranteed notice of **12 months** before any deprecated endpoint is decommissioned.

## lobo.sh Markdown Content Negotiation (acceptmarkdown.com)
Every HTML route can return raw Markdown when queried with:
`Accept: text/markdown`

Direct sibling Markdown endpoints:
- https://lobo.sh/index.md
- https://lobo.sh/about.md
- https://lobo.sh/contact.md
- https://lobo.sh/privacy.md
- https://lobo.sh/developers.md
- https://lobo.sh/essays/architecture-decisions.md