Trouble filtering server.flows.get()

[cpare]

With my TSC API version set to match the server (3.19) I am unable to issue a filtered query for flows - is this a defect, or am I doing something wrong?

Code:

import tableauserverclient as TSC

siteName = 'myTableauSite'
serverUrl = 'https://localhost'
tokenName = 'TSC_TOKEN'
tokenSecret = ''
tagName = 'Test'

tableau_auth = TSC.PersonalAccessTokenAuth(tokenName, tokenSecret, siteName)
server = TSC.Server(serverUrl, use_server_version=True)
server.add_http_options({'verify': 'c:/temp/TSC.crt'})
print("Initial Rest API version:", server.version)

s_info = server.server_info.get()
print("\nServer info:")
print("\tProduct version: {0}".format(s_info.product_version))
print("\tREST API version: {0}".format(s_info.rest_api_version))
print("\tBuild number: {0}".format(s_info.build_number))

with server.auth.sign_in(tableau_auth):
server.version = s_info.rest_api_version
print("Current Rest API version:", server.version)
all_flow_items, pagination_item = server.flows.get()
print("There are {} flows on site:" .format(pagination_item.total_available))
print([[flow.id, flow.name] for flow in all_flow_items])

print('Find flows tagged with {tagName}')
req_option = TSC.RequestOptions()
req_option.filter.add(TSC.Filter(TSC.RequestOptions.Field.Tags,
TSC.RequestOptions.Operator.Equals,
tagName))
flow_items, pagination_item = server.flows.get(req_option)

Output

Initial Rest API version: 2.4

Server info:
Product version: 2023.1.16
REST API version: 3.19
Build number: 20231.24.0809.0841
Current Rest API version: 3.19
There are 1 flows on site:
[['00000000-0000-0000-0000-000000000000', 'Test Flow']]
Find flows tagged with {tagName}
400065: Bad Request
The filter query contains a key which is not recognized for this api version.

[jorwoods]

Each endpoint accepts a different filters. See the Filtering and Sorting in the REST API to see what filters flows accept.

[cpare]

Interesting, the link you provided shows "tags" is not supported, however the source code for flows_endpoint.get() suggests a different URL, that page used language that I took at face value

Get all flows
@api(version="3.3")
def get(self, req_options: Optional["RequestOptions"] = None) -> tuple[list[FlowItem], PaginationItem]:
"""
Get all flows on site. Returns a tuple of all flow items and pagination item.
This method is paginated, and returns one page of items per call. The
request options can be used to specify the page number, page size, as
well as sorting and filtering options.

   REST API: https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_flow.htm#query_flows_for_site

The page referenced in source uses the language below, I took the "such as tags" at face value and didn't investigate the link (admittedly the same one you also provided).

(Optional) An expression that lets you specify a subset of flows to return. You can filter on predefined fields such as name, tags, and >createdAt. You can include multiple filter expressions. For more information, see [Filtering and Sorting]
(https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_filtering_and_sorting.htm).

Closing as tags is not available for Flows as of 3.19