List teams

get /v1/teams

The teams of the company, ordered by id ascending and paged with a signed cursor. Use it to find the team_id a collection accepts. A team without a name is listed as “Unnamed team”. Any collection read scope opens this catalog. For a user credential, only the teams its owner belongs to.

Autorização

Exige os escopos meetings.read, calls.read, emails.read e whatsapp.read juntos.

Parâmetros de query

Nome	Tipo	Obrigatório	Descrição
`limit`	`integer`	Não	Records per page, 1 to 100. A page may return fewer than this while has_more is still true; drive the loop by has_more, not by the size of data.
`cursor`	`string`	Não	Signed cursor returned by the previous page.

Exemplo de requisição

curl "https://api.salesbud.com.br/v1/teams?limit=...&cursor=..." \
  -H "Authorization: Bearer $SALESBUD_ACCESS_TOKEN"

Exemplo de resposta

{
  "data": [
    {
      "id": "team_01JEXAMPLE",
      "object": "team",
      "name": "Inside Sales"
    }
  ],
  "pagination": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "request_id": "req_ExampleRequestId01"
}

Respostas

Status	Descrição
`200`	Company-scoped team page.
`400`	Invalid request.
`401`	Missing or invalid credentials.
`403`	The token lacks the required scope, its user owner lost matching product access, or a connector awaits administrator approval. API_ACCESS_DISABLED identifies the feature gate for manual clients and third-party OAuth apps; AI_COLLABORATORS_DISABLED identifies the gate for first-party OAuth apps. For partner credentials, the gate also requires an active partner and the required published module, and applies to previously issued tokens.
`429`	Client rate limit exceeded.
`503`	A required audit or rate-limit dependency is unavailable.