List tags

get /v1/tags

The meeting and call tags of the company, ordered by id ascending and paged with a signed cursor. Use it to find the tag_id a collection accepts. Tags with an empty name are left out. Any collection read scope opens this catalog. For a user credential, only the tags its owner can see in Salesbud.

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/tags?limit=...&cursor=..." \
  -H "Authorization: Bearer $SALESBUD_ACCESS_TOKEN"

Exemplo de resposta

{
  "data": [
    {
      "id": "tag_01JENTERPRISE",
      "object": "tag",
      "name": "Enterprise"
    }
  ],
  "pagination": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "request_id": "req_ExampleRequestId01"
}

Respostas

Status	Descrição
`200`	Company-scoped tag 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.