postgr.esq — API Reference

OVERVIEW

postgr.esq exposes two complementary HTTP APIs:

• REST — documented below by an OpenAPI 3.1 specification rendered as an interactive Swagger UI explorer. Raw spec at /openapi.yaml.
• GraphQL — a single endpoint at POST /api/graphql. Open /api/graphql in a browser to get the GraphiQL explorer (schema introspection populates the docs and autocomplete automatically).

Every documented endpoint is served live by the Agora binary at https://postgr.esq. The same URLs typically render either HTML or JSON depending on the format query parameter or the Accept header.

The raw OpenAPI document lives at /openapi.yaml — embed it in your own tooling, generate clients with openapi-generator, or point Postman/Insomnia/Bruno at it.

SPECIFICATION

RELATED

• How To Use Each Endpoint — narrative usage guide for HTTP, IMAP, NNTP, POP3, Git, MCP.
• About postgr.esq — what this service is and why it exists.
• openapi.yaml — raw OpenAPI 3.1 spec, served directly by Agora.
• /api/graphql — interactive GraphiQL explorer for the GraphQL API.