# eesel AI API Docs

The eesel AI Website API contains public utility and preview endpoints used by eesel.ai. It is separate from the private dashboard and workspace APIs.

## OpenAPI specification

Read the complete machine-readable contract at [openapi.json](https://www.eesel.ai/openapi.json). The specification describes all published paths, request and response schemas, structured errors, the current API version, and rate-limit response headers.

## Authentication and versioning

Published website API endpoints do not require authentication. Do not send dashboard credentials. Send the optional `API-Version: 2026-08-24` header to pin the current contract. Requests without it use the current version. Unsupported versions receive a structured JSON error.

## Rate limits and errors

Responses return the RFC `RateLimit` and `RateLimit-Policy` fields plus compatibility fields. A 429 includes `Retry-After`. Errors contain `error`, `code`, `message`, and `hint` fields.

## Other developer resources

- [Authentication details](https://www.eesel.ai/auth.md)
- [Developer resource index](https://www.eesel.ai/developers)
- [MCP server](https://www.eesel.ai/mcp)
- [The eesel CLI](https://docs.eesel.ai/apis-and-developer-resources/cli)
- [Claude Code & MCP clients](https://docs.eesel.ai/apis-and-developer-resources/claude-code-and-mcp-clients)
- [Agent instructions](https://www.eesel.ai/agent.txt)