API Documentation

UZEN Labs exposes machine-readable endpoints for AI agents and developers: content negotiation (HTML→Markdown), an API catalog, llms.txt, and Agent Skills.

Endpoints

Endpoint Method Description
/ GET Homepage
/about/ GET About page
/projects/ GET Projects listing
/projects/{slug}/ GET Individual project detail
/sandbox/ GET Experiments and prototypes
/team/ GET Team listing
/team/{name}/ GET Individual team member
/blog/ GET Blog listing
/blog/{slug}/ GET Individual blog post
/docs/ GET This page
/privacy/ GET Privacy policy
/terms/ GET Terms of service
/robots.txt GET Robots exclusion protocol + AI signals
/sitemap-index.xml GET Sitemap index
/llms.txt GET LLM-friendly content summary
/.well-known/api-catalog.json GET Machine-readable API catalog
/.well-known/agent-skills/index.json GET Agent Skills discovery index

Content Negotiation

All HTML pages support Markdown output. Send an Accept: text/markdown header to receive Markdown-formatted content instead of HTML:

Accept: text/markdown

The response includes an x-markdown-tokens: true header to indicate successful conversion.

AI Agent Signals

Our robots.txt declares Content-Signal directives:

  • ai-train=no — Do not use content for AI model training
  • search=yes — Allow indexing for AI-powered search
  • ai-input=yes — Allow as grounding/input source for AI search

LLMs.txt

A structured content summary is available at /llms.txt — lists all pages, projects (with status/category/links), sandbox experiments, team members, and blog posts in a format optimized for LLM consumption.

Agent Skills

Three Agent Skills are available at /.well-known/agent-skills/:

Skill Description
read-blog Read and explore blog posts, articles, and announcements
browse-projects Discover projects, descriptions, statuses, and documentation
api-discovery Use the machine-readable API catalog for automated integration

Discovery index: /.well-known/agent-skills/index.json

Machine-Readable Catalog

An API catalog following the Linkset specification is available at /.well-known/api-catalog.json with structured endpoint information, service descriptions, and status references.