Skip to content

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.

FileContents
/llms.txtIndex: one line per page, with its URL and a one-line summary. Start here.
/llms-full.txtEvery page concatenated as plain Markdown, in reading order.
/openapi.yamlThe normative contract. Everything in the API reference is generated from it.

The format follows the llms.txt convention.

Append .md to any documentation URL to get its source instead of the rendered page:

https://docs.salesbud.com.br/guides/pagination/ → HTML
https://docs.salesbud.com.br/guides/pagination.md → Markdown

Both 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.

Three things are easy to get wrong and worth reading before you write anything:

  1. Loop on pagination.has_more, never on data.length. A page can be short or empty while more data remains. See Pagination.
  2. Branch on error.code, never on error.detail. The detail is human text and may be reworded. See Errors.
  3. Do not infer the resource kind from type. object says whether it is a meeting or a call; type only says video or audio, 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.