# OpenAPI, Postman and other files

> The machine-readable description of the API, the Postman collection, llms.txt and the Markdown version of every page.

Last updated: 2026-10-30. Source: https://docs.smartchat.marketing/en/api/openapi/

| File | What it is |
|---|---|
| [openapi.json](https://docs.smartchat.marketing/openapi.json) | The OpenAPI 3.1 description of the API. This is the one source; the reference is made from the same data. |
| [openapi.yaml](https://docs.smartchat.marketing/openapi.yaml) | The same as YAML. |
| [postman-collection.json](https://docs.smartchat.marketing/postman-collection.json) | A Postman collection with one request per call. Set the variable `api_key`. |
| [llms.txt](https://docs.smartchat.marketing/llms.txt) | A list of all pages for AI assistants. |
| [llms-full.txt](https://docs.smartchat.marketing/llms-full.txt) | All pages in one file. |
| [smartchat-docs.zip](https://docs.smartchat.marketing/smartchat-docs.zip) | All pages as Markdown plus the OpenAPI files. |
| [sitemap.xml](https://docs.smartchat.marketing/sitemap.xml) | All pages. |

Every page is also available as Markdown: add `.md` to its address, or use the link at the bottom of the page.

## Use OpenAPI to make a client

Any OpenAPI 3.1 generator can make a client from `openapi.json`. Each call has an `operationId` that equals the name used in this reference. The MCP server uses the same name for most tools; where it differs (for example `save_contact` for `create_contact` and `update_contact`), the name is in `x-mcp-tool` and in the column **REST operationId** of the [tool list](https://docs.smartchat.marketing/en/mcp/tools/). Extra fields starting with `x-` describe the permission (`x-scope`), the risk (`x-risk`), the effects (`x-effects`) and the MCP tool (`x-mcp-tool`).