Get one tag

GET 
/tags/lookup

Fetch a single tag by tag_id or by exact name (exactly one is required; 400 otherwise). A query lookup rather than /tags/{tag_id} so the same operation serves both keys. Read access requires any contact, company, or deal scope — no dedicated tag scope exists — and the tag must touch at least one module the caller can access (403 otherwise; task tags are visible to every caller).

There is no get-one endpoint upstream, so the gateway resolves the tag by paging the tag list. That is cheap for workspace reference data but is not a constant-time lookup: prefer crm_metadata_list (kind tag) when you want many tags at once.

Request

Responses

200

The tag

400

Malformed request

401

Missing or invalid token

403

Token lacks the required scope, or the user's role/permissions deny this action

404

Resource not found (or not visible to this user's role)

422

Request failed schema validation