tags/prospects_by_id
Tool: read
List prospects that have this tag.
Returns a paginated list of prospects bearing the given tag. Only meaningful for Crm-type tags (prospect tags); Campaign and Sender tags will return an empty list.
Arguments
| name | type | req | notes |
|---|---|---|---|
| id | integer | ✓ | Tag ID — the object's tagId |
| page | integer | – | 1-indexed, default 1 |
| limit | integer | – | limit default 10, max 30; see schemas/pagination |
| startingAfter | integer | – | int64 cursor from previous page's pagination.nextCursor |
Response
200 — paginated prospect list; object: see schemas/prospect. Deltas: wrapped as { items: [...], pagination }. Each item includes a tags array of embedded tag refs — see schemas/tag-ref.
Errors: 400, 401, 404, 406, 422, 429, 500 — shared schema: schemas/errors.
Invoke
Call read with name: "tags/prospects_by_id".