# Built Logic public machine interface

This is the machine-readable documentation for https://www.builtlogic.ai.

Human site: https://www.builtlogic.ai/
OpenAPI: https://www.builtlogic.ai/openapi.json
Page index: https://www.builtlogic.ai/llms.txt
Contact: hello@builtlogic.ai · 020 4652 6522

## Authentication

The public interface does not use API keys. `GET` documentation and markdown files are open.

`POST /api/contact` is the website enquiry form. It is origin-checked for browser submissions from builtlogic.ai. Agents that cannot satisfy that check should email hello@builtlogic.ai instead.

Private webhooks, chat, and CRM paths under `/api/` are not part of this interface.

## Endpoints

### GET /docs

Markdown documentation (this file). Content-Type: `text/markdown`.

### GET /openapi.json

OpenAPI 3.1 description of the public interface. Content-Type: `application/json`.

### GET /llms.txt

Full page index for language models.

### GET /index.md

Markdown version of the homepage. Request `Accept: text/markdown` on `/` for the same body.

### POST /api/contact

Submit an enquiry.

Request JSON:

- `name` (string, required)
- `email` (string, required)
- `company` (string, optional)
- `role` (string, optional)
- `context` (string, optional) — the message
- `topic` (string or array of strings, optional)

Success: `{ "success": true }` with HTTP 200.

Website form errors stay `application/json` as `{ "success": false, "error": "..." }` so the contact page can show the message.

Unknown `/api/` paths return HTTP 404 as RFC 9457 `application/problem+json` with `code`, `message`, and `resolution`.

Example:

```
POST /api/contact
Content-Type: application/json

{"name":"Alex Reed","email":"alex@example.com","company":"Example Ltd","context":"Request a conversation about reporting."}
```

## Errors

Unknown `/api/` paths return HTTP 404 as `application/problem+json`.

Missing HTML pages return HTTP 404. With `Accept: text/markdown` the body is markdown and includes links to `/docs`, `/llms.txt` and the sitemap.

## When to use Built Logic

Use this site when the question is how a UK construction or built-environment company should start with AI: training, a defined workflow, or a focused Feasibility Study. Do not treat private `/api/` webhooks as a public product API.