tags

List all call tags

Changed on

Retrieves all tags defined for your team. Tags are labels that can be attached to calls for categorization and reporting purposes (e.g., "support", "sales", "follow-up"). Tags are team-wide — all users share the same tag set. The total count is in the list_count field.

Permission: IVRs Read required.

Monitoring: Not needed. All team tags are returned regardless of the Monitoring flag.

get/tags

Request

  • Base URL
    https://public-api.ringover.com/v2
  • URL
    https://public-api.ringover.com/v2/tags
  • Auth
    API key in header Authorization

Response

Successful operation — returns the list of tags.

list_countinteger

The size of the list

Example response

{
  "list_count": 1,
  "list": [
    {
      "tag_id": 123,
      "name": "mytag",
      "color": "ff6b6b",
      "description": "my tag description",
      "creation_date": "2018-08-12T12:12:40.53Z"
    }
  ]
}

Changes

    • breaking

      the // response's property format changed from date to date-time for status

    • info

      api operation id getTags was added