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.

Authorization

Requires the meetings.read, calls.read, emails.read and whatsapp.read scopes together.

Query parameters

Name	Type	Required	Description
`limit`	`integer`	No	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`	No	Signed cursor returned by the previous page.

Example request

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

Example response

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

Responses

Status	Description
`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.