OpenAssistantAPI

User API

Tags

Freeform tags on contacts and companies

GET/tags

List tags in use across contacts and companies

Aggregates tag usage across the caller's visible contacts and globally across all companies. Backs the tag chip typeahead and audience-list editors. Sorted by total usage desc.

Query parameters

kindstring
prefixstring
limitinteger

Responses

200Tags in use
ok reqenumtrue
tags reqobject[]
tag reqstring
contactCount reqinteger
companyCount reqinteger
pageinteger
perPageinteger
totalinteger

Request

curl 'https://app.openassistant.us/api/tags' \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "ok": true,
  "tags": [
    {
      "tag": "string",
      "contactCount": 0,
      "companyCount": 0
    }
  ]
}