Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

Test

Search active test references by full-text token query.

Token-based full-text search across test name, description, intent, and labels using the Spanner SEARCH() function and idx_test_reference_search. Returns rich per-test rows (including concatenated annotated step descriptions joined through test_reference.flows -> flow_reference) ordered by SCORE() desc.

The query follows Spanner search syntax — multi-token queries default to AND. Callers can join keywords with " OR " for broader recall, or quote phrases.

post/test/references/search

Query parameters

workspace_idstring required

The workspace to search in.

Request body

querystring required

Token query. Multi-token defaults to AND; join with " OR " to broaden recall (e.g., "login OR signin OR authentication"). Adjacent tokens are treated as a phrase. Empty query returns zero rows.

search_field'combined' | 'name' | 'description' | 'intent' | 'labels'

Which tokenized column to search. "combined" searches name+description+intent+labels. Use a single field name to scope to a specific column.

application_idstring

Optional. When set, only return tests scoped to this application.

test_type'api' | 'browser' | 'performance' | 'mobile'

Type of test

mobile_platform'android' | 'ios'

The mobile platform associated with this object

label_filterstring[]

Exact-match label filter. When set, only tests whose labels array contains every entry in this list are returned. Max 20 entries.

updated_afterstring date-time

Optional. Only return tests with last_updated_time >= this timestamp.

limitinteger required

Per-call hard limit. Capped at 200 server-side.

Response

Search results ordered by relevance score (descending).

truncatedboolean required

True if any match's annotated_step_text was trimmed by the server-side character cap at either level (per-flow or total). Derived from the per-match annotated_step_truncated flags. The agent-side adaptive truncation re-truncates against a total tool-response budget.