tags/get
Tool: read
List tags with optional filtering and search.
Returns a paginated list of tags for the organization. Filter by type or search by name substring.
Arguments
| name | type | req | notes |
|---|---|---|---|
| search | string | – | Case-insensitive substring match on tag name |
| tagType | string | – | Filter by type: Campaign, Crm, or Sender |
| include | string | – | Pass prospectCount to include prospect count per tag |
| page | integer | – | 1-indexed, default 1 |
| limit | integer | – | limit default 30, max 30; see schemas/pagination |
| startingAfter | integer | – | int64 cursor from previous page's pagination.nextCursor |
Response
200 — paginated tag list; items shape: {tagId, title, description, tagType, createdAt}. Wrapped: { items: [...], pagination } — see schemas/pagination. Deltas: none.
Errors: 400, 401, 406, 422, 429, 500 — shared schema: schemas/errors.
Invoke
Call read with name: "tags/get".