---
title: "Agent docs - Roee Sivan"
description: "machine-readable interfaces on this site"
canonical: "https://roeesivan.com/docs"
last-updated: "2026-08-27"
---

# Agent documentation

Everything here is public, unauthenticated, CORS-open and read-only. There are no write operations and no API keys to obtain.

## Quick start

```
curl https://roeesivan.com/llms-full.txt
curl https://roeesivan.com/api/v1/projects
curl -H "Accept: text/markdown" https://roeesivan.com/about
```

## Endpoints

- `GET /api/v1/profile` - Identity, availability, education, work history, military service, contact channels, full technology list and project index.
- `GET /api/v1/projects` - All 6 projects with description, highlights, stack, links and trailer.
- `GET /api/v1/projects/{slug}` - One project. On an unknown slug the 404 body lists every valid slug.

## Machine-readable files

- [Full site content as Markdown](https://roeesivan.com/llms-full.txt) - every page in one file
- [Any page as Markdown](https://roeesivan.com/index.md) - append `.md` to a page URL, or send `Accept: text/markdown`
- [Projects API](https://roeesivan.com/api/v1/projects) - JSON list of all projects
- [Single project API](https://roeesivan.com/api/v1/projects/the-block) - JSON for one project by slug
- [Profile API](https://roeesivan.com/api/v1/profile) - JSON identity, education and contact
- [OpenAPI description](https://roeesivan.com/openapi.json) - OpenAPI 3.1 for the endpoints above
- [RFC 9727 API catalog](https://roeesivan.com/.well-known/api-catalog)
- [AI catalog](https://roeesivan.com/.well-known/ai-catalog.json)
- [XML sitemap](https://roeesivan.com/sitemap.xml)
- [security.txt](https://roeesivan.com/.well-known/security.txt) - RFC 9116 security contact
- [humans.txt](https://roeesivan.com/humans.txt) - who built this and with what

## Errors and recovery

Unknown project slugs return HTTP 404 with a JSON body containing `available_slugs`. Unknown paths under `/api` return a JSON 404 naming every real endpoint, and write verbs return 405 with `Allow`. Unknown pages return an HTML 404 that links to every page - or a Markdown 404, if you asked for Markdown.

## Versioning and deprecation

The version is in the path. Fields are added within a version but never removed or retyped, so a client that ignores unknown keys keeps working; a breaking change gets a new path instead. A retired version answers with `Deprecation` (RFC 9745) and `Sunset` (RFC 8594) headers for at least six months before it is switched off. No version has been deprecated so far.