Skip to main content
The reference pages below are generated from the Cognizo public OpenAPI spec. Each endpoint has an interactive console — paste your API key once and call it live.

​
Base URL

​
Authentication

Send your key in the X-API-KEY header on every request. See Authentication.

​
Response envelope

  • Success (single): { "data": { … } }
  • Success (list): { "data": [ … ], "meta": { page, page_size, total_items, total_pages } }
  • Error: { "error": { "code", "message", "details"? } }
Timestamps are ISO 8601 strings; JSON keys are snake_case.

​
The surface

38 operations across 28 paths, all brand-scoped: Those operation ids are also the MCP tool names — one vocabulary whether you call the API directly or through an AI client. Deletes are soft. A deleted brand, topic or prompt drops out of the list endpoints and its history is retained rather than purged. Deleting a topic also deactivates the prompts under it. Archived prompts keep their metrics and citations: pass filter[is_deleted]=true to list them, and the single-prompt endpoint still resolves one directly.
Set your API key in the console’s X-API-KEY field to try requests directly from these pages.