snippet

Search for snippet IDs by task

Used to query snippets by task using snippet search references for most recent version

post/snippets/search/ids

Request

  • Base URL: https://api.mabl.com
  • URL: https://api.mabl.com/snippets/search/ids
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

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

Snippet IDs matching the query

idsstring[] required

Changes

No recorded changes to this operation across all 37 revisions of this API.