Unique tag strings for filtering events and signals
Discover tag filters for Espresso intelligence
Returns a paginated, alphabetically sorted list of unique tag strings extracted from event and signal sips.
When to use: call this before searchEvents or searchSignals when an agent needs valid tag vocabulary instead of guessing filter values.
Filter behavior: tags returned here can be passed to tags on /espresso/events and /espresso/signals; multiple tag values are treated as an inclusive AND by those search endpoints.
Response formats: response_type=json returns a JSON string array. response_type=text returns one comma-separated plain-text string for lower-token MCP context.
Pagination: use offset to walk the full vocabulary when limit is smaller than the total number of tags.
query Parameters
response_typeOutput format. json returns a JSON string array; text returns the same tags as comma-separated plain text for lower token cost.
limitPage size. Default 16, max 128.
offsetNumber of tags to skip. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Discover tag filters for Espresso intelligence › Responses
Tag strings when response_type=json; comma-separated tags when response_type=text