snippet

Search active reusable snippet references by full-text token query.

Token-based full-text search across snippet name, task summary, and body using the Spanner SEARCH() function and idx_snippet_search_reference_search. Returns rich per-snippet rows ordered by SCORE() descending.

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/snippets/search

Request

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

Query parameters

workspace_idstring required

The workspace to search in.

Request body

querystring required

Full-text search query in Spanner search syntax. Whitespace-only queries return zero results.

search_field'combined' | 'name' | 'task_summary' | 'body'

Which tokenlist column to search. Defaults to combined.

snippet_typesSnippetSearchTypeEnum[]

Optional filter restricting results to the listed snippet types.

updated_afterstring date-time

Only return snippets last updated at or after this timestamp.

limitinteger

Maximum number of results to return.

Response

Search results ordered by relevance score (descending).

truncatedboolean required

True if any match had its body truncated.

Changes

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