For LLMs and agents
This documentation is published in machine-readable form as well as HTML, so an agent can consume it without scraping markup.
Entry points
Section titled “Entry points”| File | Contents |
|---|---|
/llms.txt | Index: one line per page, with its URL and a one-line summary. Start here. |
/llms-full.txt | Every page concatenated as plain Markdown, in reading order. |
/openapi.yaml | The normative contract. Everything in the API reference is generated from it. |
The format follows the llms.txt convention.
Any page as Markdown
Section titled “Any page as Markdown”Append .md to any documentation URL to get its source instead of the rendered
page:
https://docs.salesbud.com.br/guides/pagination/ → HTMLhttps://docs.salesbud.com.br/guides/pagination.md → MarkdownBoth language versions are available; the pt-BR pages live under /pt-br/.
If you only need to read data from an agent
Section titled “If you only need to read data from an agent”This API serves an MCP server at https://api.salesbud.com.br/mcp, which claude.ai reaches
as a custom connector. It exposes every public read operation as a tool, and
handles token renewal, retries and transcript windowing for you. That is the
shortest path from a credential to an agent reading meetings — see
MCP server.
Write an HTTP client instead when you are building a service rather than driving a model.
If you are generating integration code
Section titled “If you are generating integration code”Three things are easy to get wrong and worth reading before you write anything:
- Loop on
pagination.has_more, never ondata.length. A page can be short or empty while more data remains. See Pagination. - Branch on
error.code, never onerror.detail. The detail is human text and may be reworded. See Errors. - Do not infer the resource kind from
type.objectsays whether it is ameetingor acall;typeonly saysvideooraudio, and the two are independent. See Meetings and calls.
There is no refresh token — renewal is calling /oauth/token again. That is a
property of the client-credentials grant, not an omission.