Sign in
Flow

Query flows by task

Used to query flows by task using flow references for most recent main version

post/flows/references/task

Query parameters

workspace_idstring required

The workspace associated with this query

Request body

application_idstring

Restricts the query to entities of a given application ID

database_connection_idstring

Restricts the query to entities with the given database connection ID (only used for Snippet queries)

flow_type'validate_page' | 'login' | 'verify_url' | 'mablscript' | 'check_links' | 'visual_page_validation' | 'api' | 'mobile'

the type of flow

limitinteger required

The max results to return

mobile_platform'android' | 'ios'

The mobile platform associated with this object

reusableboolean

If specified, will only return entities with the given reusable flag

snippet_typesSnippetTypeEnum[]

Restricts the query to entities with the given snippet type (only used for Snippet queries)

session_idstring

The id of the mabl AI session, if any

task_descriptionstring required

The task description

rerank_with_llmboolean

When true (default), the candidate list is LLM-reranked against the task description before the top limit are returned. When false, the LLM rerank is skipped and the raw datastore-ordered candidates (ASC by COSINE_DISTANCE) are returned. Either way the response honors limit; the internal candidate widening multiplier varies by endpoint (endpoints that group results after the fetch keep the widened set so grouping does not underfill limit).

Response

Array of flows matching the query

cursorstring

Cursor used for pagination

Changes