---
title: "Trelice public API"
description: "Public Trelice search and marketing API operations, machine-readable contract, error format, and action-safety guidance."
canonical_url: "https://www.trelice.com/api.md"
---
# Trelice public API

The public Trelice website API supports read-only search plus two unauthenticated marketing operations. It is not a customer-data or protocol-authoring API.

## Contract and documentation

- [OpenAPI 3.1 specification](https://www.trelice.com/openapi.json)
- [Developer resources](https://www.trelice.com/developers)
- [Authentication notes](https://www.trelice.com/auth.md)
- [RFC 9727 API catalog](https://www.trelice.com/.well-known/api-catalog)

## Operations

- `GET /ask` or `POST /ask` performs read-only, deterministic search over authoritative public Trelice pages and can return JSON or Server-Sent Events.
- `POST /api/leads` requests a Trelice demo and creates a real follow-up request.
- `POST /api/document-suggestions` submits a protocol-derived document idea for product review.

The marketing operations accept JSON or form-encoded bodies and return typed JSON for API clients. Errors include `code`, `message`, and `resolution`. Agents must obtain explicit user approval for the exact submitted data before either marketing POST.